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The current Hypertext Edit¬ 
ing System and its manuals 
(EDIT phase and FORMAT phase) 
are preliminary releases of a 
first stage of development. 
Implementation of this first 
version was begun towards the 
end of May, 1968 and we started 
doing useful work using a con¬ 
stantly evolving system towards 
the end of September. (A 130 
page manual on the Brown 
University Student Operating 
System was finished in Novemb¬ 
er; all our software documenta¬ 
tion since then, including 
these manuals, has been done on 
the Hypertext Editing System.) 

Needless to say, there are 
many developments and improve- 
'inents still to be made, both to 
the system and to its documen¬ 
tation (and there are even a 
few lingering bugs). He expect 
to provide updates to the cur¬ 
rent version for the next sev¬ 
eral months, and then start 
imple mentation of the next ver¬ 
sion -- a multi-user, multi¬ 
station system with many 
changes and new features. 


HYPERTEXT EDITING SYSTEM 


PREFACE 


0. PREFACE 


A paper describing the sys¬ 
tem, to be delivered at the 
second Computer Graphics Con¬ 
ference at the University of 
Illinois in March, 1969 (avail¬ 
able upon request), describes 
general background, philosophy, 
and ideas to be incorporated in 
the next version; these manuals 
serve only as preliminary 
reference manuals. 


Feel free to use the current 
system arid its documentation 
for experimenting or producing 
manuscripts — let us know 
about any problems you may 
_ encounter so that we may 
explain or fix them. Good 
luck! 


The work 

reported in this manual was 
supported in part by a contract 
between the International 
Business Machines Corporation 
and Brown University. The 
manual was edited by Steven 
Carmody, Kenneth Denzel, David 
Sice, and Robert Hallace. 
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The Brown University Hyper¬ 
text Editing System is a com¬ 
puter system for text handling 
and display, having a number of 
related uses. 

It is both a sophisticated 
system for the composition and 
manipulation of manuscripts, 
and a reading machine on which 
to browse and query written 
materials having complex struc¬ 
tures. By a Hypertext we mean 
strings of text arbitrarily 
interwoven and connected, i.e., 
nonlineal text. There are two 
essentially distinct phases for 
manipulating hypertexts: 

In the. EDIT phase, a user 
can create and manipulate a 
'Hypertext using three classes 
of functions: EDIT commands, 

STRUCTURE commands, and TRAVEL 
commands. Combined, these 
functions allow a user to cre¬ 
ate new text, to edit text 
which has been previously typed 
into the system, and to browse 


INTRODUCTION 

t 

1- INTRODUCTION 


• through . text which already 
exists. He may also structure 
a text in any manner desired, 
•either while it is being 
created, or after the entire 
text has been written as a 
Hypertext. 

In ■ the FORMAT phase, the 
user can format (i.e., specify 
the lay-out of) a previously 
edited Hypertext for conversion 
to conventional hard copy form, 
via IBM's TEXT360 program and a 
high speed line printer. 

Reference material on the 
system is divided into two 
manuals, one for the EDIT 
phase, and one for the FORMAT 
phase. The user should become 
familiar with the system by 
first reading the 0. of 
Illinois paper, and then trying 
simple functions such . as 
INSERT,DELETE, and SUBSTITUTE. 
(He can get started just by 
trying the simple functions, of 
course.) 


/ 

(r 
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2. PRELIMINARIES FOR THE EDIT PHASE 


2.1 SCREEN AREAS 


There are three areas on the 

scope screen. These are: 

/ 

HYPERTEXT DISPLAY AREA: The 
actual Hypertext is displayed 
in this area, 40 lines of text 
(or blanks) at a time. This is 
the area where the user does 
all of his creating and editing 
of text. 

ANNOTATION AREA (or TAG 
AREA): In this area the LINK 
and TAG explainers are dis¬ 
played. Also, any labels or 
explainers that are typed in by 
the user appear in this area, 
as he is typing them, and prior 
to his accepting them. 

- PROMPT AREA: In this area, 
below the annotation area, the 
system "prompts" the user as to 
his possible alternative 
actions and informs him of any 
errors he has made. In the 
EDIT phase this is a system 
area, and the user never types 
in it; in the FORMAT phase, he 
may choose options or type in 
parameters in this area. 


2.2 BASIC EDIT MODE — HOME 
PLATE 


When a display first 
appears, the system will be in 
basic EDIT mode, with the 


prompt: "HIT FUNCTION KEY OF 
DESIRED ACTION". The user then 
pushes the desired function 
key, indicates with the light- 
pen where on the screen (i.e., 
with respect to which 
character (s) ) he wants the 
indicated function to occur, 
and finally accepts or rejects 
the results. 


2.3 PROMPTS AND MESSAGES 


The prompts and massages 
which appear in the prompt area 
at the bottom of the scope 
display are important aids to 
the user. They explain the 
options that are available to 
him in the current state of the 
system. For example, the 
prompt will specify what the 
user is to do next in order to 
complete the function he has 
specified. 

The general format of the 
prompt is: 

FUNCTION:. DIRECTIONS. 

The directions generally 
include the accept/reject 
options described below. the 
term "string" in the directions 
denotes an arbitrarily long 
sequence of characters, blanks, 
or special symbols. Anything 
from a single character to a 
full screen of text is thus a 
string; naturally, if the 
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string whose endpoints must be 
identified is a single charac¬ 
ter, it must be lightpenned 

twice. 

If the user does something 
wrong, the prompts have been 
designed to direct him out of 
difficulty. It is always wise 
to read the prompt before pro¬ 
ceeding, i.e, to make sure that 
- the correct function key has 
been pressed, that the system 
has processed the interrupt, 
and that it is waiting for the 
user’s next action. As a 
further indication that the 
system is ready and waiting, 
the function key which was 
pressed lights up. 

* 

*» 

If the user attempts to do 
something which the prompt does 
not require, no operation will 
occur. Thus if the user tries 
to type in his INSERT before he 
lightpens the place where it is 
to begin, the keyboard will not 
function; if the user lightpens 
the screen when he is supposed 
to be typing, the screen will 
blink but nothing else will 
happen. 


2.4 ACCEPT VERSOS CAN'CEL 


• With most of the EDIT func-’ 
tions (operations or commands) , 
the user has the option of 
accepting or rejecting the 
function before its results are 
actually entered into the 
Hypertext data structure, i.e. 
while he is in the process of 
exercising the function, or 
even after he has viewed its 
results. 


PRELIMINARIES FOR THE EDIT PHASE 


The user ACCEPTS an opera¬ 
tion, e.g. an INSERT, by 
simultaneously pressing the 
ALTERNATE CODING (ALTN CODING) 
key, located at the extreme 
left in the upper row of the 
alphanumeric keyboard, and the 
END key, also located in the 
top row of the keyboard (the 
key for the numeral 5) . 

The user rejects (CANCELS) a 
function during any of its 
intermediate and final stages 
by pressing the CANCEL function 
key on the function keyboard 
(this is not the same as press¬ 
ing the alphanumeric key for 
the numeral 0). Pressing the 
CANCEL key cancels the function 
completely 1 , results in no 
operation occurring, and brings, 
the user back to basic EDIT 
mode status, so that he can 
activate his next function. 
Thus the CANCEL option can be 
employed as a panic or reset 
button in case the user feels 
he has done something wrong or 
is dissatisfied with his 
results. 


2.5 HYPERTEXT AREAS AND SCOPE 
PAGES 


A Hypertext area is a con¬ 
tinuous, arbitrarily long piece 
of text (or the "space" 
reserved for it) which is ter¬ 
minated either by an "end area 
line" (* * * END * * *) on the 
screen, or by a BRANCH depar- 


1. There is as yet no partial 
reset of the last phase within 
a function. 
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ture point (i.e. BRANCH 
explainer). A "scope page" or 
"screen" is a "window" which 
permits the user to view (up 
to) 40 lines of a Hypertext 
area. If a Hypertext area is 
less than 40 lines long it can 
be displayed in its entirety as 
one display page. If it is 
not, the user must move the 
window by exercising one of the 
traveling functions. 


2.6 STARTING A NEW AREA 


There are only two methods 
for obtaining a "blank" (i.e., 
new) area of Hypertext: by 
creating a brand new data set 
(see appendix A), or by using 
the NEWAREA key while exercis¬ 
ing a KAKEBRANCH or a MAKELINK 
function (see section 5 . 2 ). 
Initially, the only "text" in a 
new area is the "start new area 
line": 


PRELIMINARIES FOR THE EDIT PHASE 


***** START *****, 


and the "end area line": 


* * * END * * *. 


After the user has created a 
new area, he may travel to it, 
but before he does any editing 
in this area, it is wise that 
he place a LABEL in this new 
section of the Hypertext. (See 
MAKELABEL). The label should 
be made following the last 
asterisk of the start line 
since the end line is not pen- 
detectable. After the label is 
made, the user should DELETE 
all of the start line, being 
careful not to also DELETE the 
label at the same time. If the 
start line is not DELETE! it 
will appear in any hard copy 
printout; the end line will 
never appear. 
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3. GOOD 


3.1 PROPER USE OF THE LIGHTPEN 


When pointing the lightpen 
at a character, the user should 
be sure to center the two dots 
of light directly over it so 
that parallax doesn't cause him 
to point at the wrong charac¬ 
ter. This is particularly 
important for dim characters 
such as the period. Further¬ 
more,.after the character has 
been "seen" (at which point the 
screen will blink briefly) the 
user should check to see that 
the correct character was 
indeed identified before 
proceeding. 


3.2 LACK OF RESPONSE AND LOCKED 
KEYBOARD 


If the user operates either 
of the keyboards but the edit¬ 
ing system fails to respond, he 
should try simultaneously 
pressing the ALTERNATE (ALTN) 
CODING key and SHIFT key 
located at the bottom left edge 
of the alphanumeric keyboard. 
This action clears the "locked" 
condition of the alphanumeric 
keyboard which may result from 
a mistaken operation of this 
keyboard. As long as the 
alphanumeric keyboard is 
locked, the Editing program 
will fail to respond to depre¬ 
ssions of the function keys. 


SCOPE TECHNIQUES AND PRECAUTIONS 


SCOPE TE CHNIQUESAND PRECAUTIONS 


If the keyboard is clear and 
the system still does not 
respond, the /360 may be busy 
processing some one else for a 
few seconds — relax! If the 
keyboard is clear and the /360 
is not looping or preoccupied, 
the user may have locked him¬ 
self out by pressing function 
keys before previous interrupts 
had been properly processed by 
OS — it gets confused easily. 
His only recourse at this point 
is to reload the editing 
system. 


3.3 CURSOR, JUMP KEY, AND 
ADVANCE KEY (ALPHANUMERIC 
KEYBOARD) 


Hitting the JUMP key (by 
accident), located on the far 
left of the alphanumeric key¬ 
board, will have no effect 
except locking the keyboard if 
the "cursor" (the horizontal 
line (typing bar) which repre¬ 
sents the current position of 
the "typewriter carriage") is 
not displayed on the screen. 
If, however, the cursor is 
located in the main display 
area it will probably "jump" 
down to the beginning of the 
prompt area when the JUMP key 
is hit. At this point the user 
should hit the JUMP key until 
the cursor is back at the loca¬ 
tion at which it was initially 
displayed, from where the user 
may move it by retyping or 
using the ADVANCE key. 
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If convenient, it is always 
best (easiest) to CANCEL the 
function when the JUMP key is 
hit and begin again. If the 
JUMP key doss displace the cur¬ 
sor and the user accepts the 
function, all kinds of graphic¬ 
al junk is likely to result on 
the screen, and it is best to 
leave via ABEND and start 
afresh. 


3.4 LEAVE FUNCTION 


All EDITing and FORHATing is 
done on a work data set which 
was copied from the user's per¬ 
manent data sat when he ini¬ 
tially requested the data set 
by name. Consequently there 
are several procedures for 
updating the user's permanent- 
data set from the work data 
set. 

l 

The LEAVE function allov:s 
the user to lightpen one of the 
following options for cleaning 
up or finishing up the current 
Hyp ertext session: 

1) COPY - This allows the 
user to save all his work on 
disk but does not end the ses¬ 
sion. The work data set which 
he has been editing overwrites 
(replaces) his permanent data 
set on disk. The program 
returns to the page in the work 
data set from which the COPY 
function was activated. Fre¬ 
quent COPYing is desirable — 
if the /360 gets clobbered, all 
the work done since the last 
COPY is lost. (We suggest 
using COPY every 10 to 15 
minutes, or while the user is 


scratching his head wondering 
what to do next — COPYing 
takes less than 20 seconds for 
medium sized data sets). While 
the COPYing is taking place, a 
massage ("THIS SPACE AND TIME 
FOR RENT") will appear. 

2) FINISH - Like COPY this 
allows the user to save on disk 
his work done during the cur¬ 
rent session. The program 
halts, ending the session. The 
sane message as in COPY 
appears. Naturally the system 
may be reloaded now and work 
done on the same or a different 
data set. 


3) ABEND - This allows the 
user to scratch all his work 
since the last COPY for this 
session and ends the session 
(used when the user has messed 
everything up completely, when 
he is demo-ing, or just fooling 
around). At Brown this action 
requires a reply by the opera¬ 
tor before the "monitor" reap¬ 
pears (the partition is being 
re-initialized). 


4) RETURN - For non Brown 
University users this is the 
same as ABEND; at Brown, this 
will return the user to the 
monitor without operator inter¬ 
vention, after an appropriate 
clean-up as in ABEND. However, 
a little space is lost after 
each RETURN, so that after many 
RETURNS, when the monitor is in 
a small partition (98K), the 
system might return to the mon¬ 
itor with a completion coda of 
80A; don’t worry about this -- 
continue as usual. 
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3.5 MYSTERIOUS GLITCHES 


If the user experiences dif- 
faculties such as causing the 
borabout message to appear on 
the screen (“THIS PROGRAM 
WORKS, BUT SOME PEOPLE DON * T 
KNOW HOW TO USE IT...”), or 
getting locked out while both 
the alphanumeric keyboard and 
the /360 are ok, he should have 
the system reloaded and try 
again (in case of the bombout 
message, pressing CANCEL or 


SCOPE TECHNIQUES AND PRECAUTIONS 


RETURN may suffice). Occasion¬ 
ally v/e have found that when 

totally inexplicable things are 
happening, re-IPLing magically 
cures them. Particularly in a 
multi-programmed environment . 
such strange things do occa¬ 

sionally happen, and are seldom 
repeatable — grin and bear it, 
remembering that genuine bugs 
are usually repeatable. If the 
situation can be made to repeat 

itself, describe it, and send 

us a dump. 
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4. EDIT COMMANDS 


4.1 INSERT When the INSERT is finished 

the user accepts it by depres- 
; s’ sing the ALTERNATE CODING (ALIN 
To enable direct text inser- CODING) key and the END key • 

tion from the scope keyboard, simultaneously. The text, 

the user must first depress the which wraps around from the 

INSERT function key. The cur- right scope margin to the left 

sor (the typing bar) will as it is typed, will then be 

appear automatically at the end formatted as ragged-right 
of the text in the display (i.e. , words will not be bro- 

area, provided there is an end ken). (The user should not 

of area line displayed: type strings of more than 73 

. characters without a blank! 

:. { r if he does, the display from 
*** END ***. that point on will be blank and 

s- all below is lost, in which 
case it is best to ABEND.) 

If the user is working on a new 

area, the cursor may or may not ■ If an INSERT is to be made 

appear after the last asterisk within existing text, the user 

(*) in the start area line: must lightpen the point at 

which he wishes the INSERT to 
♦fr********START**********, begin. As he types, the text 

spreads to form as large a gap 
but he may start typing there as needed for him to type his 

regardless. insertion. If this latter 

option is chosen, a maximum of 
• The user may now type in 255 characters, approximately 

continuous text until he three and one half lines, can 

approaches the bottom of the be typed in at one time. 

'•display' 1 page (about 35 Again, the user accepts the 

lines). If he desires to con- insert by pressing the ALTERN- 

tinue, the user accepts the ATE CODING and END keys. 

INSERT (see below), SCROLLS 

forward as many lines as he If the user tries to go 

wants to, or more quickly, one beyond the 255 character limit, 

page forward and then backuard the cursor will stop at that 

by line until the text from the point and further typing by the 

preceding page appears at the user will simply result in typ- 

top of the screen. The user ing over the same single char- 

now reinitiates (presses) the acter. If the user ACCEPTS the 

INSERT function and can type in INSERT at this tine he will 

another page without probably only get the first few 

interruption. ■ words he typed in, the rest 
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being lost. However, if he 
notices that he has gone to the 
very end, he can BACKSPACE one 
space and then ACCEPT,and the 
first 255 characters will be 
INSERTed correctly. (The BACK¬ 
SPACE key is in the upper right 
hand-hand portion of the 
alphanumeric keyboard.) 

Rotes: 

c--\4 

1) The user can get around 
the 255 character limitation in 
one of two ways, depending upon 
the length of the INSERT. If 
the INSERT is reasonably short 
the user can perform a sequence 
of INSERTS and ACCEPTS. Howev¬ 
er, if the INSERT is quite 
long, the user can SCROLL to 
the blank portion of the area 
(just above the end area line), 
and type the INSERT. He can 
then REARRANGE it into place 
when he has finished typing. 
If the end area line is not 
displayed, he can travel to 
another area (e.g. an area 
reserved for this purpose), 
type the INSERT into this area, 
and finally REARRANGE it into 
place. 

To insert long segments of 
text the user might prefer to 
use CARD INPUT (Appendix E). 

2) If at any time an error 
is made in the INSERT (prior to 
ACCEPT) the user can BACKSPACE 
the cursor one character at a 
time, type over the error and 
then ADVANCE the cursor one 
character at a time by retyping 
the correct letters. Using the 
SPACE bar to pass any following 
correct characters will result 
in their being replaced by 
blanks; the ADVANCE key should 


be used instead to advance past 
the correct characters. 


3) If the user discovers 
that he has made an error in 
typing at some place a number 
of character spaces from his 
"present location'* (i.e., where 
the cursor is) , a much quicker 
way of moving the cursor 
through the text is by pressing 
the CONTINUE key and then tap¬ 
ping the BACKSPACE key until 
the error is reached by the 
cursor, releasing the CONTINUE 
key, and then typing over the 
error. The CONTINUE and 
ADVANCE keys may then be used 
to reposition the cursor back 
to where he was typing. 

4) Since an INSERT can be 
made only directly following a 
character already positioned on 
the screen and not in some 
blank area, the user must first 
type in the INSERT behind this 
preceding character, and then, 
if necessary, position the new 
string properly using FORMAT- 
ting functions such as PARA¬ 
GRAPH or SKIP LINES. 

5) In the EDIT phase any 
special characters such as LINK 
asterisks (*) or BRANCH 
explainers, labels,, or TAG and 
FORMAT markers are treated as 
literal character strings dur¬ 
ing EDITing operations and are 
therefore not differentiated 
from the text proper. Thus one 
may insert after such a marker 
as if it were ordinary text; 
similarly, using DELETE (see 
below), one may (inadvertently) 
remove such markers - be 
careful! 
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Inserting after after a 
label (lightperming the charac¬ 
ter string) may mess up the 
display while typing is pro¬ 
ceeding, but everything will be 
properly ACCEPTed. 

. 6) On long inserts, it helps 
to use the SWITCH PHASE key 
(sea section 4.11) to paragraph 
the text so as to make it more 
legible and flicker-free. 

7).The user may INSERT and 
ACCEPT only one string with 
each operation of the INSERT 
function key. 


4.2 DELETE 


. * : . v 

The user may DELETE a string 
of characters by lightpenning, 
in either order, the end points 
(i.e., characters) of the 
string to be DELETEd. This 
portion of the text will be 
removed from the display, and a 
blank space will appear where 
the DELETion occurred. The 
user has the option of ACCEPT- 
ing the DELETion or CAHCELing 
it in the usual way. If it is 
ACCRPTed, the endpoints of the 
text will be closed up; if it’s 
CANCELLed, the DELETEd string 
will reappear. 

• The user may DELETE a maxi¬ 
mum of a whole display of text 
since he nay not travel between 
the lightpenning of the DELE¬ 
Tion endpoints. 

Any LINK or BRANCH points of 
departure embedded in the 
string will also be DELETEd, 
and their entry points (i.e.. 
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the sections of text they lead 
to) will be lost (unless the 
user restructures JUMPS to them 
or has previously LABELEd 
them). Similarly, any labels, 
or TAG or FORMAT markers 
internal to the string will be 
DELETEd. 


4.3 DELETE SINGLE CHARACTER 


This function is basically 
the same as the previous delete 
function with the limitation 
that only one character may be 
DELETEd, but with the advan¬ 
tages that it requires only one 
lightpenning to DELETE the 
character, and that any number 
of single DELETions can be made 
with each operation of the 
function. 

.» • 

The user does not have the 
option of ACCEPTing or CANCEL- 
ing . each . DELETion or group of 
DELETions performed as a whole 
— all DELETions done in this 
mode are irrevocable, being 
accepted as they occur. Only 
the CANCEL function key ends 
the mode; the user nay then go 
on to select another function. 


4.4 REARRANGE 


This function allows the 
user to move or "REARRANGE" a 
portion of the text from one 
point to another. The user 
light pens (in any order) the 
end points of the string to be 
moved and then lightpens the 
point at which this string is 
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to be inserted. The text being 
REARRANGE:! is displayed at the 
indicated point and removed 
from its current location so 
that the user can see how it 
looks. The user may reposition 
the indicated insertion point 
by lightpenning any number of 
points in succession until he 
finds a position that suits 
him. When the user ACCEPTS the 
REARRANGE, the indicated string 
is INSERTed at the last indi¬ 
cated point and DELETEd from 
its original position. 

The user may REARRANGE up to 
one whole scope page of text. 
However, if he REARRANGES more 
than 255 characters, only the 
first 255 will be displayed for 
his approval, on the screen at 
the insertion point, prior to 
ACCEPTing. After ACCEPTing the 
operation, however, the whole 
REARRANGE! section will appear 
correctly. 

After having lightpenned the 
endpoints of the string to be 
REARRANGE!, the user may travel 
to other sections of the text. 
Once he has finished traveling, 
the prompt message will tell 
him to lightpen the point at 
which he wants the REARRANGE! 
string to be inserted.- 

i • 

Since one usually REARRANGES 
whole words or phrases rather 
than pieces of words, the REAR¬ 
RANGE function automatically 
inserts a blank between the 
point of insertion (i.e., the 
character which was light- 
penned) and the leading charac¬ 
ter of the string. To REAR¬ 
RANGE within a word therefore, 
it is usually faster to SUBSTI¬ 
TUTE for the incorrect portion 


of the word. Also, when a 
string is REARRANGE!, the 
blanks which were used to pad 
out the right margin of each 
line are not removed and will 
appear between words. They are 
•removed, however, when the text 
is printed, so don't worry 
about them. 


Notes: 


1) In the current version, 
REARRANGE (and COPY and BORROW . 
as well) has the (odd) property 
of changing special symbols 
such as FORMAT characters (# 
and $, see FORMAT Manual Sec¬ 
tion 2.2) , LINK asterisk (*) , 

TAG marker (3)) , and BRANCH 
explainers, into literal chara¬ 
cters. This means that any 
special meanings are lost, and 
if text including these markers 
must be moved, it is less con¬ 
fusing to DELETE them soon- 
after moving. If a BRANCH 
explainer is part of the REAR¬ 
RANGE! string it will be moved 
as normal text, with the possi¬ 
bility of a few bonus charac¬ 
ters (true for COPY or BORROW 
as well). Also, if text 
including PARAGRAPHing formats 
is REARRANGE!, it may look a 
little misplaced prior to 
ACCEPTance; after ACCEPTance, 
the PARAGRAPH formats are 
deleted, i.e., turned into #'s. 


2) If a large, formatted 
section needs to be REARRANGEd, 
it is better not to REARRANGE 
it but to fake it by restruc¬ 
turing the Hypertext as 
follows: ... . • a. i i VL 

" * • “ TUiC ^Uv ir\T ca » 



3 —-i- Tlv iwci i O r> c* We 
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3) If one REARRANGES a piece 
of text which contains a label, 
the characters of the' label 
will become part of the REAR¬ 
RANGE! text, with the possibi¬ 
lity of a few bonus characters 
and extra blanks as well. 

4) REARRANGing a string into 
itself will clobber the system 
and is therefore not 
recommended. 

5) The user may REARRANGE 
one string with each operation 
of this function. 


4.5 COPY 


. This function is similar to 
REARRANGE in that the indicated 
character string is inserted at 
the indicated point. The only 
difference is that the string 
is not deleted from its origin¬ 
al position. 

As above, the user may 
repostion the indicated inser¬ 
tion point so as to move the 
copied string around until he 
has decided upon the correct 
point for its insertion. To 
copy text from another data 
set, use MERGE (Appendix F). 


4.6 HORROR 


This function is similar to 
;COPY with one -added facility 
which indicates that the string 
;was BORPORad: the orginal 
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string is sandwiched by a *•-/» 
.in<front of the first character 
and a "/'* after the last, 
whereas the copied (BORRONed) 
string, to distinguish it, is 
sandwiched before and after by 
a "+/" and a M /" respectively. 
These additional characters are 
now part of the text, and hence 
are printable (or editable, for 
that matter). 

The user has the added 
option of tacking on an 
explainer (or citation) which 
will appear after the original 
string and after the BORROWed 
copy wherever it is inserted 
into the text. When the user 
exercises this option to enter 
; or change the explainer (the 
. default explainer is a blank) 

. ha lightpens the words "CHANGE 
EXPLAINER" in the prompt mes¬ 
sage, types in the new explain¬ 
er (a maximum of 255 charac¬ 
ters) and ACCEPTS it as usual. 
He must then CANCEL in order to 
BORROW or to execute any other 
function. 

In the current system the 
explainer is purged after the 
scope session (i.e., when the 
program is terminated) or when 
the explainer is changed and 
replaced by another explainer. 
Any occurrences of the 
explainers remain in the text, 
naturally. An explainer is 
displayed immediately following 
the closing "/" of the BORROHed 
string and is terminated by the 
characters "//". Thus the com¬ 
pleted "BORRON" looks like: 

+/BORROWED STRING/EXPLAINER//. 

An explainer could be used 
as a citation to indicate the 
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source 

of the string. 

and. 

per- 

haps. 

when and by 

whom 

the 

BORROW 

was made. 

This 

is 

handy. 

for instance. 

when 

tr y- 

ing t 

o arrange notes 

from 

diverse sources into 

a coherent 


structure. 

Note: The explainer will also 

be printed on any hard copy. 


4.7 SUBSTITUTE 


This function can be consi¬ 
dered an ordered combination of 
the functions DELETE and 
INSERT. The user lightpens the 
end points of the string to be 
SUBSTITUTEd for and this string 
is DELETEd from the display 
(and from the text if the SfJB- 
STITUTion is subsequently 
ACCEPTed). The user then types 
in the substitution string and 
.this is INSERTed in place of 
the string which was DELETEd. 

The user may SUBSTITUTE any 
one string for another with 
each operation of this func¬ 
tion; the two strings do not 
have to be of equal length. Up 
to a whole display page can be 
deleted but the replacement 
string may not be longer than 
255 characters. If a longer 
SUBSTITUTion is desired, the 
user may first DELETE and then 
use the procedures described at 
the end of 4.1 INSERT for long 
insertions. 

One of the common uses of 
SUBSTITUTE is to INSERT a char¬ 
acter string directly in front 
of (i.a., without intervening 
blanks) an existing string. 
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For example, to put a left 
parenthesis in front of the 
first letter, "H", of "HYPER¬ 
TEXT", SUBSTITUTE the string 
" (H" for the "H". Also, to 
close up the space in 


"LIGHT PEN", 


one would substitute "TP" for 
n T P». 


4. 8 MAKE INSTANCE 


This function allovrs the 
user to "subroutine" or quote a 
piece of text by name. The 
endpoints of the string which 
is to become the INSTANCE are 
lightpenned, and a label (inde¬ 
pendent of normal text labels) 
which will be used to catalogue 
the INSTANCE must be typed in 
and ACCEPTed. The original 
text remains unchanged on the 
display screen, but a copy of 
the INSTANCE and its label is 
stored for future use (during 
that current scope session 
only, in the current system). 


While this function is much 
like the COPY function, it does 
not require the user to light- 
pen the endpoints of the string 
each time it is to be inserted; 
he need only "call" the 
INSTANCE by using its label and 
lightpen the point of its 
insertion, as shown below. As 
an example, a separator line of 
asterisks is a useful INSTANCE. 
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4.9 INSERT INSTANCE 

This function allows the 
user to insert at any point in 
the text an INSTANCE which he 
has previously "subroutined". 
The user light-pens the point 
at which he wishes the INSTANCE 
to be inserted and then types 
in and ACCEPTS the label of the 
particular INSTANCE to be 
inserted. As with the INSERT 
function the text plus the 
inserted INSTANCE is shown on 
the screen and the user may now 
ACCEPT the insert. Only one 
INSTANCE can be inserted with 
each operation of the function. 


4.10 SUPPRESS 


This function allows the 
user to SUPRESS (or redisplay) 
the appearance on the screen of 
either FORMAT markers (# or $) 
or labels (character strings 
with lines through them). He 
must lightpen the appropriate 
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part (s) of the prompt and then 
exit from the function by hit¬ 
ting the CANCEL key. He may 
undo either SUPPRESSion by cal¬ 
ling for . the function again, 
and lightpenning the appropri¬ 
ate part(s) of the prompt: the 
prompt acts like a flip-flop. 
Note that in the FORMAT phase 
this function is located in a 
slightly different position, 
and does not give a prompt -- 
the button itself is the flip- 
flop there (for FORMAT markers 
only) . 


4.11 SNITCH PHASE 


This key flip-flops between 
the EDIT and FORMAT phases. 
When switching to the FORMAT 
ph ase, the system is automatic¬ 
ally in PARAGRAPH & CAP1 mode 
(see FORMAT Manual, Section 
4.13). When switching phases, 
make sure the switch has been 
fully completed by checking the 
prompt, before operating any 
function keys. 
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Once the text has been 
entered into the Hypertext 
Editing System it can be struc¬ 
tured into separate sections 
using the three structure com¬ 
mands below. It is also poss¬ 
ible to add "empty” areas to 
the Hypertext structure which 
may be filled v/ith text using 
EDIT commands. 


5.1 MAKELABEL 


The user may label a section 
of the text by lightpenning the 
point at which he wants the 
- label to be inserted and then 
typing in a unique, one to six 
character label which will 
identify this particular sec¬ 
tion of the text. (The label 
can be composed of any keyboard 
characters.) The label will, 
appear after the lightpenned 
point with a line through it 
. (identifying it as, a label) . 
This label will also be entered 
in the label table so that it 
can be accessed by the GETLAB3L 
function. The text at the 
point where the actual label 
character string is inserted 
remains continuous with the 
exception that the label 
appears on the screen, possibly 
in the middle of a character 
string if the user put it 
there. Labels do not appear in 
hard copy. 


5,._STRUCTURE_COMHANDS 


• 

To delete a label the user 
may operate either of the 
DELETE functions, DELETE one or 
• more of the characters within 
the label, and ACCEPT the DELE- 
Tion. The entire label will be 
DELETEd and will be purged from 
the screen display of that 
area. However, it will remain- 
in the label table and will be 
"undefined" (see SETLABEL). 


The present system does not 
check for duplicate labels, and 
only the first of duplicate 
labels is accessible. 


5.2 LINKS AND BRANCHES 


The next two functions, 
MAKELINK and MAKEBRANCH, are 
quite similar in their struc¬ 
turing. Their basic dif¬ 
ferences become apparent most 
readily in hard copy printout, 
where a LINK is treated as a 
footnote. 


A number of differences also 
exist in their screen operation 
and locations. The BRANCH is a 
physical tie to another area of 
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the Hypertext. 2 There may be 
more than one BRANCH at the end 
of a page (forming a "BRANCH 
MENU"); the user is forced to 
take one of them to continue 
with the text. The LINK dif¬ 
fers in that it provides the 
user with the option to travel 
to the LINKed section, while 
the default case is for him to 
continue reading text on that 
page. 

Both LINKS and BRANCHes are 
symbolized by an asterisk (*) 
at their point of occurrence 
(point of departure) in the 
text, and by associated 
explainers. An explainer is a 
small string (less than 255 
characters in length) used as 
an annotation, teaser, instruc¬ 
tion to the reader, meta¬ 
footnote, etc.: the LINK 

explainer appears in the anno¬ 
tation area, while the BRANCH 
explainer appears in-line, next 
' to the BRANCH asterisk (*) . 


5.3 MAKE BRANCH 


This function allows the 
user to create a BRANCH to some 
other section of the .Hypertext: 

1) The initial prompt tells 
the user to lightpen the point 


2. One is allowed to create a 
LINK or BRANCH which loops back 
into the same area — this 
causes no problems for brows¬ 
ing, but must be done carefully 
so as to keep the Print Program 
from looping. (See Printing, 
Part 3, of the Format Manual.) 
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of departure from which he 
wishes the BRANCH to be made. 

2) The next prompt message 
tells the user the four options 
that he now has: "MAKEBRANCH: 
TYPE LABEL, HIT MEN AREA KEY, 
LITEPEN TEXT, OR TRAVEL." The 
first option allows him to type 
in the label (probably, though 
not necessarily, previously 
defined) of the area to which 
he wants the BRANCH to go 
(ACCEPTing it as usual). The 
second alternative is to press 
the NEWAREA key which sets up a 
new Hypertext area for the 
user., (Until the user adds new 
BRANCHes into this new area or 
creates a label within the 
area, he' can not access it in 
any other way than by taking 
this particular BRANCH -- see 
section 2.6). These first two 
are the most straightforward 
methods for making branched 
Hyper texts. 

The user also has the option 
of (traveling arbitrarily and 
then) lightpenning the point in 
the text to which he wants the 
BRANCH structured. Note that 
the prompt message may change, 
depending on the mode of tra¬ 
vel, but after any traveling 
has been completed, the MAKE- 
BRANCH prompt returns. Also, 
the lightpen may be used both 
to travel, and to point into 
the text after traveling has 
been completed. 

For instance, if the BRANCH 
is to be made to a label but 
the user has forgotten the 
label, he may use the GETLA3EL 
function, lightpen the label in 
the label table, and, after 
having decided that this is 
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indeed the desired label, may 
then either type in the label 
or lightpen the actual label 
(the character string with the 
horizontal line through it) ; 
he could then RETURN to the 
BRANCH point of departure. 

3) The user must then type 
in and ACCEPT a mnemonic BRANCH 
"explainer" which he may use to 
describe where (or why) = the 
BRANCH is going, ACCEPTing it 
as usual. If the user types in 
no explainer (i.e., he ACCEPTS 
immediately), the default 
explainer is just the BRANCH 
asterisk (*) . 

If the user ACCEPTS the 
operation, the BRANCH will be 
structured, and the BRANCH 
asterisk (*) followed by the 
BRANCH explainer will appear at 
the lightpenned point on the 
screen. Any text on the same 
Hypertext page following the 
BRANCH now disappears from the 
screen and, unless the user has 
labeled this text, or struc¬ 
tured another JUMP into the 
text, he will not be able to 
get to it without deleting the 
BRANCH. 

To delete a BRANCH the user 
operates either of > the two 
DELETE functions and DELETES 
any character (s) of the BRANCH 
explainer. The BRANCH will be 
DELETEd and, if no other 
BRANCHes exist at the BRANCH 
point, any text following it in 
the same area (or the * * * END 
* * * line) will reappear. 

Notes: 

1) Once a BRANCH is DELETEd,' 
the user cannot in general get 
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to the section where that 
BRANCH led unless that section 
had been previously labeled 
explicitly, or unless another 
BRANCH or LINK leads to it. 

2) More than one BRANCH can 
appear at the end of a screen 
page, providing for a BRANCH 
"menu". the user can choose 
from the menu which area he 
desires to go to (see BRANCH). 

3) In the current version, 
BRANCH explainers may not be 
edited in any way: at best no 
operation will occur and at 
worst the BRANCH will be 
deleted and all following 
BRANCHes will not be displayed. 
If it is necessary that one or 
a "menu" of BRANCHes be edited, 
the user must recreate them 
with the MAKE BRANCH function. 
It is entirely possible to 
insert a new BRANCH in the 
middle of an existing menu by 
attaching it during the MAKE- 
BRANCH operation to any charac¬ 
ter of the previous BRANCH 
explainer. 

4) The user should LINK or 
BRANCH to a BRANCH MENU not by 
lightpenning the first BRANCH 
in - the menu, but by labelling 
the top of the menu or light- 
penning the character preceding 
the menu. 


5.4 MAKE LINK 

To make a LINK, the user 
follows the same actions as in 
making a BRANCH. thus: 
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1) The user lightpens a 
point where the LINK point of 
departure is to occur. 


. 2) A prompt message appears 
telling the user the options 
that are now available: "MAKE- 
LINK: TYPE IN LABEL, HIT 

NEWAREA KEY, LITE-PEN TEXT, OR 
TRAVEL." The user can now type 
in* a label, press the NEWAREA 
key, or (travel and) lightpen a 
section of the text. 

3) He then types in and 
ACCEPTS a LINK explainer. The 
default explainer is an 
asterisk (*) . 

To repeat, a LINK differs 
from a BRANCH in that: 

1) The LINK is represented 
as a point of departure 
asterisk within the text at the 
insertion point. Text in the 

„ same Hypertext Area following 
the point of departure remains 
on the screen, and the explain¬ 
er appears at the bottom of the 
screen in the annotation area. 
To take a LINK, one lightpens 
the LINK *. 

2) When hard-copy printout 

of the text is made, LINKS are 
treated as footnotes and appear 
at the bottom of the printed 
page in which the LINKed point 
appears. The text to which the 
LINK was made is not printed 
like ordinary Hypertext: if 

the area LINKed to is more that 
ten lines long (at the current 
printed column width), the 
remaining text will be wrapped 
into the main text following 
the link point. (See section 
3. 1 of the FORMAT manual). 


Thus nested or looping LINKS 
to arbitrary sections of Hyper¬ 
text are allowed as far as the 
EDIT mode and on-line browsing 
are concerned, but are not 
recommended for printout—the 
user must temporarily restruc¬ 
ture the Hypertext in accor¬ 
dance with the restrictions in 
section 3.1 of the FORMAT 
manual. 


5.5 MAKE TAG 


This function allows the 
user to make marginal notes to 
himself or an on-line reader. 
Upon pressing this function key 
the user is asked to lightpen 
the point at which he wishes 
the TAG to be made. The user 
then types in (and ACCEPTS) his 
marginal note (TAG explainer) 
which appears at the bottom of 
the screen in the annotation 
area, for his future reference; 
following the lightpenned point 
a TAG marker " 5 )" will appear. 

Tag markers and the corres¬ 
ponding margin notes do not 
appear in any hard-copy prin¬ 
tout; they are simply for the 
benefit of the on-line Hyper¬ 
text reader and editor. 


5.6 SCROLLING EXPLAINERS 


There may be several TAGs 
and LINKs appearing on the same 
scope display and since only 
one explainer (the one closest 
to the top of the scope page) 
at a time can be displayed in 
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the annotation area at the bot¬ 
tom of the screen, there are 
two functions which allow the 
user to "SCROLL" through the 
explainers of the LINKS and 
TAGs on that displayed page. 


explainer list is moved back 
one. If the first explainer on 
the screen page is displayed 
this function will have no 
operation. 


5.6.1 EXPLAINERS FORWARD 


5._6 ._3_Scr ol 1 in g_Ma rker s_0 f f _t he 
Screen 


Upon operation of th 
tion the explainer 1 
moved forward, displa 
next explainer for that 
page. If the last expl 
displayed this functi 
have no operation, 
explainers may be SCROL 
secutively. To see any 
ing ones on that page, 
must travel, for inst 
SCROLLing a line. 


is func- 
ist is 
ying the 
display 
ainer is 
on will 
Only 6 
Led con- 
remain- 
the user 
ance by 


To 

tion 

to wh 

user 

line 

expla 

also 

marke 

expla 


ge 
of w 
ich 
can 
at 

iner 

the 


t positive identifica- 
hich explainer belongs 
marker or S) , the 
SCROLL FORWARD one 
a time until the 
changes. This is 
way to find where the 

particular 


for 


iner is located 


5.6.2 EXPLAINERS BACKWARD 


This function is the reverse 
of the above, i.e., the 
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There are a group of func¬ 
tions which provide the user 
with the ability to ’’travel” 
through a Hypertext by SCROL- 
Ling or by jumping (via BRANCH, ' 
LINK, and GETLABEL described in 
Section 5. Structure 

Commands). 


6.1 SCROLLING 


» 

If the Hypertext area is 
longer than one display page 
the user may operate the SCROLL 
functions to move the display 
window backward or forward. 

■ r 

These scroll functions will 
work only within a "Hypertext” 
area; to travel between areas 
requires a jump (LINK, BRANCH, 
or GETLABEL). 


6.1.1 SCROLL FORWARD BY LINE 


The user may scroll the 
screen display forward one line 
by pressing this functon key, 
one. line for each operation of 
the key. When the end of an 
area is reached (either at a 
BRANCH explainer or the "end 
area line”), lines will simply 
be scrolled off the top and 
blank lines fed in at the 
bottom. 


HYPERTEXT EDITING SYSTEM 
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6.1.2 SCROLL BACKWARD BY LINE 


The user can also SCROLL 
BACKWARD one line at a time, 
one line for each operation of 
the function key. When the 
, beginning of the area has been 
reached no change will occur on 
the scope display with this 
function. Depending on how the 
page has been edited, especial¬ 
ly with regard to the PARAGRAPH 
function, SCROLL BACKWARD 3Y 
LINE may actually scroll back 
several lines at a time. 


6.1.3 SCROLL FORWARD BY PAGE 


SCROLL FORWARD BY PAGE 
allows the user to SCROLL FOR¬ 
WARD through the text by a 
whole display page. The last 
line of the previous display 
becomes the first of the pre- 
- sent one. When the end of the 
• Hypertext area is reached this 
function will have no effect on 
the scope display. 


6.1.4 SCROLL BACKWARD BY PAGE 


SCROLL BACKWARD BY PAGE is 
exactly the reverse of SCROLL 
FORWARD BY PAGE. (At least) 
one whole display page is 
SCROLLed BACKWARD. When ■ the 
beginning of the Hypertext area 
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is reached, this function will 
have no affect on the scope 
display. 


6.2 LINK 


The LINK function allows the 
user to travel to and thus 
display a LINKed-to area of his 
choosing. When this function 
key is pressed, the user is 
asked to lightpen the asterisk 
{*) within the text represent¬ 
ing the LINK point of depar¬ 
ture. If the user does not 
lightpen a LINK asterisk, an 
error message will appear at 
the bottom of the screen asking 
him to "try again". Opon suc¬ 
cessful lightpenning of a LINK 
asterisk, "a LINK is taken" to 
the point to which that LINK 
was structured. Thus . the new 
display on the screen will be 
the section of text pointed at 
by the LINK. If the user tries 
to LINK to an undefined label, 
(i.e. either the LINK was 
structured to a label not yet 
created.or the label has since 
been DELETEd) an error message 
will appear at the bottom of 
the screen. 


6.3 BRANCH 


This function allows the 
user to BRANCH to another sec¬ 
tion of the text. When this 
function key is pressed the 
user is asked to lightpen the 
explainer of the BRANCH he 
wishes to take. If the user 
does not lightpen a BRANCH 


explainer, an error message 
will appear at the bottom of 
the screen asking him to try 
again for a BRANCH explainer. 
Upon the successful lightpen¬ 
ning of an explainer, "a BRANCH 
is taken" to the point to which 
that BRANCH was structured. If 
the user tries to BRANCH to an 
undefined label (i.e., the 
BRANCH was structured to a 
label which had not yet been 
defined, or which has since 
been DELETEd), an error message 
will appear at the bottom of 
the screen. 


6.4 GETLABEL 


This function allows the 
user to access any of the 
labeled sections he has pre¬ 
viously structured within the 
text. When this function key 
is pressed the text presently 
on the screen is replaced by 
columns of labels (the one-to- 
six character strings struc¬ 
tured in the MAKE LABEL func¬ 
tion) arranged alphabetically. 
The user lightpens the label of 
the section to which he desires 
to travel. Currently, if a 
label has been previously 
DELETEd it will remain in the 
table, but when lightpenned a 
message will appear at the bot¬ 
tom of the screen telling the 
user that the label is non¬ 
existent and asking him to try 
again. When a "legal" label is 
lightpenned, the section with 
that label will be displayed on 
the screen (the label and the 
text following will start in 
the upper left hand corner of 
the screen). 
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GETLABEL provides a very 
fast way of moving around "in” 
a Hypertext, and then RETU RNing 
to the previous place (s) 
visited-- as such it is often 
preferred to SCROLLing around 
which does not allow RETORNing. 
Consequently, the user is 
advised to use labels copious¬ 
ly, say, one per subsection of 
his manuscript. In this manner 
he creates an on-line "index". 


6.5 RETURN 


Each time the user executes 
one of the three jump func¬ 
tions, i.e. either: 

1) takes a branch, 

2) takes a link, or 


\ 
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3) retrieves a labeled 
section, 

{"gets" or "takes" a 

label) 

the screen configuration from 
which he traveled is remembered 
(i.e., placed at the top of a 
pushdown stack). On each 
operation of the RETURN func¬ 
tion the display on the screen 
reverts to the last Hypertext 
section from which the user 
executed one of the jumps. 

Therefore the RETURN func¬ 
tion may be operated succes¬ 
sively until the user returns 
to his starting point (i.e., 
until the stack is exhausted) . 
Further RETURNS result in no 
further operation. Note that 
SCROLLing commands are not 
remembered. 
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7._APPENDICES 


Note for all JCL which follows: 

1) Whenever "VOLUME=SER=AVDPAK" is specified below, substitute for 

AVDPAK your disk volume name. 

2) The DSNAMEs shown may be changed, as long as the change is uniformly 

made wherever used. , 

3) The delimiters "<" and ">•' are used to show where user information 
is needed. 

. : • t 

4) If your Disk Unit is a 2311, double all the disk SPACE allocations 

indicated. . 


APPENDIX A: BASIC SYSTEM CONFIGURATION 


- The minimum requirements for running the system are: 

1) - a 360/50 with PCP, MFT or MVT, including BSAM and GAM (Graphic 
Access Method) . however, variations must be made when moving from one 
configuration to another; 

2) a 2311 or 2314 Disk Unit; 

3) a 2250 Mod 1 with an 8K buffer and the Graphic Design Feature, or 
a Mod 3 scope; and 

4) a TN (or equivalent) printer chain, required for operating 

systems which cannot handle characters not on a normal print chain, 
useful for other systems to get both upper and lower case from the 
TEXT360 program. V 
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APPENDIX B: INITIAL CREATION OF SYSTEM 


The Hypertext System is generated by running the following two jobs. 
The first (//ONLOAD) unloads the system from the included tape ani 
places it in HTEXTSYS. The second (//SETUP) initializes the various 
works data sets used by the system. 


//ONLOAD JOB (ACCOUNTING INFO) r 'UNLOAD TAPE',HSGLEVEL=1 
// EXEC PGM=IEHMOVE 
//SYSPRINT DD SYSOUT=A 

//DD1 DD UNIT=2400,VOLUME=SER=<TAPE VOLUME>, 

// DSNAME=HTEXTSYS,LABEL=(1,SL),DISP=OLD 

//DD2 DD UNIT=DISK,VOLUME=SER=AVDPAK,DISP= (NEW,KEEP) , 

// DSNAME=HTEXTSYS,SPACE= (TRK, (20,5,5)), 

// DCB=(RECFM=U,BLKSIZE=3072,LRECL=80) 

//SYSUT1 DD VOLUME = SER=AVD PAK,DISP = OLD,UNIT=DISK 
//SYSIN DD * 

COPY PDS=HTEXTSYS,FROM=2400=(<TAPE VOLUME>,1) , 

TO=2314=AVDPAK,FROMDD=DD1 

/* 


//SETUP JOB (ACCOUNTING INFO) ,'CREATE WORK AREAS',MSGLEVEL=1 
// EXEC PGM=IEBGENER - 

//NEWWORK DD DSNAME=WORKAREA,UNIT = DISK, DISP=(NEW,KEEP), X 

// VOLUME=SER= AVDPAK, SPACE= (TRK, (<MAX>,0) ,,CONTIG) ,X 


// DC B=(RECFM=F,BLKSIZE=7200,LRECL=7200) 

//NEWMERGE DD DSNAME=MERGE,UNIT=DISK,DISP= (NEW,KEEP) , X 

// SPACE= (TRK, (15,3) ) , VOLUM E=S ER=A VD P AK , X 

// DC B=(RECFM = FB,BLKSIZE=1600,LRECL = 80) 

//NEWOUT DD DSNAME=T360IN, TJNIT=DISK, DISP= (NEW,KEEP) , X 

// SPACE= (TRK, (50,5) ) ,VOLUME=SER=AVDPAK, X 

// DC B=(RECFM = FB,BLKSIZE=1600,LRECL = 80) 

//NEWPRTOT DD DSNAHE=PRTEILE,UNIT = DISK, DISP=(NEW,KEEP), X 

// DCB=(RECFM = FB,LRECL=132,SLKSIZE=132) , X 

// SPACE= (TRK, (50,10) ) , VOLU ME=SF.R= AVDPAK 

//NEWDICT DD DSNANE=DICT,DISP= (NEW, KEEP) , X 

// DCB= (,BLKSIZE=2000) ,UNIT = DISK, X 

// SPACE= (TRK, (10,5) ) , VO LUME=SER=AVDPAK 

/♦ 


Note 1: For the SPACE parameter of the NEWWORK DD card, <M1X> should 
be replaced by the maximum number of tracks (text data set size) you 
will be using, with an upper limit of 260 tracks. 
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Note 2: If a 2311 Disk Unit is used instead of a 2314, change the DCB 
parameter on the //NEW90RK DD card to: 

DCB= (RECFM=F,LRECL=3600,BLKSIZE=3600) 

Note. 3: The DSNAME for the //NEWOUT DD card (T360IN) is specified a 

SYS1.P1518.AVD.T360IN on the SYSIN card for the TEXT360 job specifie 
in Appendix A of the Format Manual. Make sure that the two DSNAMES are 
the same. 1 

. • 

Note 4: The DSNAME for //NEUPRTOT (here PRTFILE) should be the same as 
that for TEXT35 0's //PRTOT card (there SYS 1.P15 18. AVD. PRTFILE) . 


Note 5: Finally, . the DSNAME for //NEHDICT (here DICT) should be the 

same as that for TEXT360's //DICT card (there SYS1.DICT). : 


APPENDIX C: NORMAL HYPERTEXT RUN 


This is the JCL needed to run the Hypertext Editor on the scope: 


//SCOPE JOB (ACCOUNTING INFO) ,’THE -GROUP’,MSGLEVEL=1 
//JOBLIB DD DSNAME=HTEXTSYS,UHIT = DISK,DISP=OLD, X 

// VOLUME=SER=AVDPAK 

// EXEC PGM = HYPRTEXT 

//H FILE DD DSNAME=DUMMY,UNIT = DI5K,DISP = OLD, X 

// VOLUME=SER=AVDPAK 

//30RKFILE DD DSNAME=HORKAREA,UNIT = DISK,DISP=OLD, X 

// VOLUME=SER=AVDPAK 

//OUT DD DSNAHE=T350IN,UNIT=DISK,DISP=OLD, X 

// SPACE= (TRK , (50,50)), VOLOME=SER= AVDPAK 

//SCOPE DD UNIT=SCOPE 

//SYSPUNCH DD DSNAME=MER3E,ONIT=DISK,DISP=OLD, X 

// VOLU M E=S E!R = AVDP AK 

/* 


The HFILE DD card above has a dummy DSNAME parameter which will be 
replaced by the DSNAME typed in by the user at the beginning of the 
scope session. 

The WORKFILE DD card refers to the scratch area onto which the data 
-set is copied during the work session. This data set must absolutely 
and positively be contiguous. - 

*7 The'-OUT DD card refers to the data" set onto which the intermediate 
• output, from the Print Program is placed. This data set later serves as 


IEDIT MANUAL 27 


Mi 0J 




HYPERTEXT EDITING SYSTEM 


21 January, 1959 APPENDICES 


the input for the TEXT360 program which is run to get hard copy 
printout. s 

* “'Ml 

The SCOPE DD card refers to the scope unit to be used on this run of 
the program. 

• *• 

The SYSPUNCH DD card refers to the data set which will temporarily 
store the text to be moved (merged) from one data set to another. This 
data sat later serves as input to the MERGE program. 
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APPENDIX D: CREATING DATA SETS 


The following job initializes a data set of specified name and size: 
//CREATE JOB (ACCOONTING INFO),•CREATE DS' ,MSSLEVEL=1 

//JOBLIB DD DSNAME=HTEXTSYS,UNIT=DISK,DISP=OLD, X 

// VOLUME=SER=AVDPAK 

// EXEC PGM = CREATE, PARM=‘< N TRACKS >' ^ 

//CREFILE DD ONIT=DISK,VOLUME=SER=AVDPAK,DISP=(NEW,KEEP), X 

// DSNAME=<NEW DATA SET>,SPACE= (TRK, (< N TRACKS >, 0) ) 

/* 

The parameter (PARM= ) on the EXEC card indicates the number of 
tracks on the disk of primary allocation. Approximately 1 track should 
be allowed for each expected page of printout (2 for 231 1*s). This 
number must also be included in the SPACE parameter of the CREFILE DD 
card. 

The data set named on the CREFILE card is the one initialized. If 
this program is run on an already existing data set, that data set is 
re-initialized and whatever was in the data set is lost. 


All editing is done on the system's work data set, and only if the 
user explicitly requests it, by using the COPY or FINISH options of the 
LEAVE function, is the permanent data set replaced with the updated 
work data set. 
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APPENDIX E: CARD INPUT 


The following job allows the user to insert text into a data set 
through the card reader: 

* 

//CARDS JOB (ACCOUNTING INFO), ' CARD INPUT »,MSGLEVEL =1 

//JOBLIB DD DSN AM E=HTEXTS YS,UNIT = DISK,DISP=OLD, X 

// VOLUME=SER= AVDPAK " 

// EXEC PGM=CHARGEIT,PARM='<NUM,CHAR>* •' 

//WORKFILE DD UNIT=DISK,VOLUME=SER=AVDPAK,DISP=OLD, X 

// DSNAME=<EXISTING DATA SET> 

//SYSIN DD * 

<LA BEL> 


Text goes here 

• . * ■ - 

: • i ; .i , 

• - V ..*: . 

• /* • 

The DSNAME for the WORKFILE DD card must be the name of the data set 
into which the insertion is to be made. 

The LABEL after the SYSIN DD card is the one to six character label 
with which the user wants to identify the insertion. The new text is 
not linked to the rest of the text, but its label may be referenced 
with a BRANCH, 3ETLABEL, etc. Note: this cannot be a label that 

al ready exists in the data set. 

The parameters (PARM= ) on the EXEC card are: 

1) NUM— the number of columns beginning with column 1 in which the 

text to be read in has been punched; 

•* \ 

2) CHAR— a single character (e.g., <, *, etc.) that will be 
interpreted as a PARAGRAPH 5 CAP1 format every time it occurs in the 
punched input text. 

The assumed values are: NUM=80 and CHAR=<; no PARM need be specified. 
If you want to change NUM while using the assumed CHAR, specify 
PARH=*<NUM> 1 . If you want to change CHAR while using the assumed NUM, 

-specify PARM= 5 ,<CHAR>*. As examples, to use only 72 columns of each 
card, and to use * for paragraphs, you would specify PARK='72,* 1 ; to 
use all 80 columns but specify -* for paragraphs, you would use 
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APPENDIX F: MERGING DATA SETS 


This job will MERGE part or all of one data set into another data 
set: 

//MERGE JOB (ACCOUNTING INFO),'2ND STEP OF MERGE»,MSGLEVEL=1 
//JOBLIB DD DSN AME=HTEXTSYS,UNIT = DIS K,DISP=OLD, X 

// VOLUNE=SER=AVDPAK 

// EXEC PGM=MERGE 

//HFILE DD DSNAME=DUMMY,UNIT=DISK,DISP=OLD, X 

// VOLUME=SER= AVDP AK 

//WORKFILE DD DSNAME=WORKAREA,UNIT=DISK, DISP=OLD, X 

// VOLUME=SER= AVDPAK 

//SCOPE DD UNIT=SCOPE 

//SYSPBNCH DD DSNAME=MERGE,UNIT=DISK,DISP=OLD, X 

// VOLUME=SER=AVDPAK 

/* 

To do a MERGE, the user starts by using . the normal Hypertext job 
(//HYPRTEXT JOB) with the data set containing the text to be merged. 
The user presses the MERGE function key. As the prompt message 
indicates, he may now (or at any time during the merging process) 
change the BRANCH LEVEL (from its default value of the 1st branch) by 
lightpenning "CHANGE BRANCH OPT.". (see Sect. 3.2.3 Branch Level 
Option of the Format Manual for a description of branch levels.) He 
may now (travel and) lightpen the start and end points of the text to 
be merged. The Prompt Area will return to the "home-plate" message: 
"HIT FUNCTION KEY OF DESIRED ACTION", signifying the completion of the 
first step which copies the selected text to a work area. 

To merge the text from the work area into another (or the same) data 
set (the second and final step), he next runs the //MERGE job. The 
user is asked to type in the name of the data set into which the text 
will be merged, hit the "JUMP" key on the keyboard (not any of the jump 
function keys), and type in the label to be associated with the new 
text. As with CARD INPUT, the new text is not linked to the rest of 
the text, but it may be referenced (via its label) with a BRANCH, LINK, 
or GETLABEL. 
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APPENDIX G: TAPE/DISK MOVES 


These are useful for saving infrequently used data sets on tape. 
They are standard IBM Utility Programs. 

. ... _. .. . • 

• , • 

1) Disk to Tape 

. ' ; •/ 1 ; . 

I ; 

//COPY JOB (ACCOUNTING INFO),'DISK TO TAPE»,MSGLEVEL=1 i 

// EXEC PGM=IEBGENER i 

//SYSUT1 DD UNIT=DISK,VOLUME=SER=AVDPAK,DISP=OLD, • X 

// DSNAME=<HYPERTEXT DATA SET> 

//SYSUT2 DD DSNAME=<TAPE DATA SET>,UNIT = <TAPE UNIT>,L ABEL= ( #,NL), X 
// DCB= (R£CFH=F,LRECL=7200, BLKSIZE=7200) , X 

// DISP= (NEW,KEEP) ,VOLUME=SER=<TAPE VOLUME>. 

//SYSIN DD DUMMY 

//SYSPRINT DD SYSOUT=A ' 

/* 

ft = File Sequence Number on the" tape 


2) Tape to Disk 

//COPY JOB (ACCOUNTING INFO),'TAPE TO DISK • ,MSGLEVEL=1 
// EXEC PGM = IEBGE NER 

//SYSUri DD DSNAM E = <TAPE DS>,UNIT = <TAPE UNIT>,LABEL= (#,NL), X. 

// DCB=(RECFM=F,LRECL=7200,BLKSIZE=7200) , X 

// VOLUME=SER = <TAPE VOLUME>,DISP=OLD 

//SYSUT2 DD DSNAME=<HYPERTEXT DATA SET>,UNIT=DISK,DISP=OLD, X 

// VOLUME=SER=AVDPAK 

//SYSIN DD DUMMY - 

//SYSPRINT DD SYSOUT=A 

/* . 

# = File Sequence Number on the tape 

Special note - if a 2311 Disk Unit is used rather than a 2314, change 
the DCB parameter in both jobs to: 

DCB=(RECFM=F,LRECL=3600,BLKSIZE=3600). 
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APPENDIX H: FUNCTION KEY LABEL AND NUMBER 




• 

CANCEL 

0 

LEAVE 

1 

Unused 

2 

SWITCH 

PHASE 

3 


RETURN 

4 

NERAREA 

5 

% 

MERGE 

6 

; 

SUPPRESS 

7 

SINGLE 

DELETE 

8 

Unused 

9 

GETLABEL 

10 

HAKE 

LABEL 

11 

MAKETAG 

12 

EXPLAINER 

FORWARD 

13 

,* • * 

' • 

EXPLAINER 

BACK 

14 

Unused 

15 

/» 

LINK 

16 

MAKE 

LINK 

17 

MAKE 

INSTANCE 

18 

INSERT 

INSTANCE 

19 

r 

COPY 

20 

' • 

* 

REARRANGE 

21 

BRANCH 

22 

MAKE 

BRANCH 

23 

BORROW . 

24 

V 

DELETE 

25 

SUBSTI¬ 

TUTE 

26 

INSERT 

27 

SCROLL 

BACK 

PAGE 

28 

BACK 

LINE 

29 

FORWARD 

PAGE 

30 

FORWARD 

LINE 

31 

SCROLL 
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INTRODUCTION 


INTRODUCTION 


The Format Phase of the Hypertext Editing System provides 
the user with the facility to format and print onto hard 
copy his entire Hypertext created in the Edit Phase. It is 
assumed that you are familiar with the functions of the Edit 
Phase. 


All o 
the Ed i t 
keys a r 
able, de 
Hyoertex 
using a 
of cse11i 
su do 1 etn c \ 
of fiaur 


f the text perusing (traveling) options available in 
Phase are included, and the appropriate function 
e the si me. The current formatting options avail- 
scribed in detail below, are sufficient"to format a 
t so t a a t it can be immediately printed in - hard copy 
high speed printer (possibly followed by photo- 
n -J) • Provisions are also included for printing 
nta 1 listings, such as a table of contents or a list 


es 


Rough draft copies, corresponding line for line with the 
screen appearance, may also be obtained (see Sec. 3.2.2, 
Quickie Printout). This mode prints all characters as 
capitals (if a regular orint chain is used), and requires 
only a minimum of formatting (e.g., paragraphing, skipping 
lines a n d i n 1 e n t i :i a) „ 


describe! here are tried on-line. 


The Format Manual will be most useful if the actions 


The reference 
this manual, Figu 
TMXT3 n 0 Reference 


source for the details of Parts 
e s v 1 and 4 f and the A p p e n 1 i c e s 
'lU Wl tin a Guide. 


4 and 5 of 


is 


IBM 


^cknovlgdaeaents: The work reported in this manual was 

supported in part by a contract between the International 
Business M a c h i n o s C o r n o r a t i o ri and Brown University . The 
manual i?as edited by Aridries van Dan. 
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GENERAL REMARKS 


• ' The Format Phase of the system is entered from the Edit 
Phase via a ‘function '£ey (SNITCH PHASE). You may switch 
back and forth between phases using this key, editing and 
formatting at will. When the Format Phase is initially 
entered, the system will automatically be in the PARAGRAPH f> 
CAP1 mode (see Sec. 9.13 below). This makes initial 
paragraphing of an unedited text quite facile. 


The switching betw 
by pressing any of 
need to use the C \NG E 
(u n1ike the E dit P 
tion, the CANCEL func 
Phase to its initial 
THE ‘FORMATTING PHAS 
formatting done no to 
been accented In the 


eon format modes is 
the function keys. 

L function key to e 
base). However, as 
tion key will always 
state, whose prompt 
E: HIT DESIRED F 

this point, however 
data structure. 


accom piished solely 
There is never any 
nd a format mode 
a "fail-safe 11 func- 
return the Format 
message is "THIS IS 
UNCTION KEY. 11 Any 
,‘will already have 


All of the traveling commands that 
Edit Phase are applicable here, and 
the same function keys. Keep in mind 
travel while in an "edit" format mode. 


are 

they 

that 


offered in the 
are controlled by 
one may always 


2.1 SPECIFICATION AND TYPES OF FORMATS 


Two t y o e 


formats and methods of inserting them are 


used in the system-- "edits" and "alters”. 


Uhon specif 
the format a 
t h e n you a ro t 
desired point 
of the "edit" 
digh t then b 
several relate 
HANGING I M D 77 N 
the Prompt Ara 
step in the so 


yin i a n "edit." format, you must first choose 
nd any options dealing with that format, and 
hen f'ree to apply this format to any and all 
s of your Hynertext. You initially press one 
format function keys (e.g. INDENT). You 
o asked to choose, with the lightpen, which of 
d formats you desire (e.g. REGULAR INDENT or 
f) . Any choices applicable are displayed in 
a at the bottom of the screen. As a final 
eclfication process you might be asked to type 
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in a number 1 (e.g., 6 meaning an indentation of six spaces). 

After having designated an "edit” format, you may apply 
it to any points of vour text with the Lightpen. The 
specified format will remain active as you travel to other 
areas of vour Hypertext via the travelling commands. Thus 
you could capitalize your entire Hypertext having pressed 
the capitalize key (C.APl) only once. Note that this lifters 
from the Edit Phase where, in most cases, one function key 
hit. allows only one action. 

Each time a format is indicated by penpointing at the 
text display, the format is immediately entered into the 
Hypertext data structure. Thus, if a mistake is made, the 
incorrect format must be deleted (see Sec. 2.3, Interroga¬ 
tion and Deletion of Formats). When specifying multiple 
capitals (MELT CAES) or underscoring (UNDERSCORE) formats, 
which reguire pairs of lightpen hits, the formats are 
entered into the text only after each pair of hits. They 
are, in fact, entered as two separate formats: a begin 
capitalization or underscore, and an end capitalization or 
underscore. Thus, to preserve symmetry, both should be 
deleted if you choose to delete one of them. If you end 
this mode after making an odd number of hits, the last 
lightpen hit is ignored. 


The second method of inserting formats is used when 
entering ’’alter 1 ' formats, so-called because they "alter" the 
overall format of the printed copy (e.g., formatting the 
pages in double columns with a specified running title). 
Typically, many types of alterations are specified together 


at only a few places in the text, in particular at th 


staru 


of: 


the text. 

t > /a -> /—• t 


When vo a 


<r* 

O C7 


?lect 


the ALTER function key, you 
will be asked to lightpen a point in the text. After 
choosing t h te point, you may select (from a menu on the 
display), as many of the "alter" formats as you wish 
specified at that point. Each time you make a choico, the 
■format is entered into the data structure but of course it 
may be interrogated 'and deleted later. 


1-. You must then either accept this number 
ACCEPT) or reject it (by pressing any of the 
for your next formatting choice, or CANCEL). 


(ALTN CODING S 
function keys 
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2.2 SYMBOLIZATION OF FORMATS 


Most of the f 
actually appear 
options would bo 
lino just ifco ti 
impossible (e. g. 
soaces wide on 

4 - — 

Thus, in .7 e n o r a 1 

ra present act by 

»■ — 

sign (£) and the 


ormatting specified by the user will not 
on the scope-displayed text. Many of the 
impr.atical to implement (e. g., performing 
on and hyphenation on-line)^and a few are 
, displaying a single column of text BO 
a display unit whose width is only 74). 
, the specified formatting will only be 
a marker. The markers used are the number 
dollar sign ($). 


Several considerations resulted in the use of only two 
marker types to represent the formats. Primarily there are 
not as manv readily discernable markers as format options. 
If 50 different marker types were used, it would be quite 
difficult to distinguish between markers and text. In 
addition, a typical user could not be bothered to learn what 
marker stands for what option. 


Each time a formatting option is appli 
with the lightpon, a number sign (3) o 
will appear on the scope display as the " 
"marker" corresponding to that format. 
(REGULAR) , PARAGRAPH, PARAGRAPH S CAP 1, 
formatted on the display. Whenever a f 
specified by pen-pointing at an actual 
text, the format symbol (and therefore 
will in general precede that character. 
SIGHT BRACKET, " SURE RSCRTPT3, END KEEPS, 
of which immediately p ol!ow the lightpena 
anv marker or symbol (e.g., a link marks 
symbol) is pointed to with the lightpen, 
will alwavs annear before it. 


ed to the Hypertext 
r a dollar sign (3) 
format symbol" or 
In addition, INDENT 
and SKI? will be 
ormatting option is 
character of the 
the format option) 
The exceptions are 
and END" TABLE.*, all 
ed character. If 
r or another format 
the format symbol 


A distinction should be made between the characters, £ 
and S, and the ^ormg.t symbols, - and 5. The format symbols 
will not be printed out, while the characters will. If 
there is ever any question as to which is which on the 
display, the function key labeled SUPPRESS can be utilized. 


Pressing this key suppresses the display of all format 
markers, thus anv £ or 3 remaining on the display is an 
actual character of the text. The SUPPRESS function key 
acts like a "flip-flop" sv/itch* i. e. , the next time it is 
pressed, all the format symbols will reappear. A particular 
* or Z in question could also be interrogated (see Sec. 
2. S, Interrogation and Deletion of Formats, below). If you 
try to interrogate a character of the text, the prompt area 
will give a message indicating that you light penned a 
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non-format character. Also, in general, if several 
have been specified together, they should each ha 
gated to ensure that they are in the desired and 
order (explained in Part 4 where applicable)* 


formats 
interro- 
correct 


Format symbols are not distinguished from regular text in 
the Edit Phase-- they may be deleted, substituted for, 
inserted after, etc* Act with caution, however; if, for 
instance, one inserts a blank or a special character between 
a PARAGRAPH £ CAP1 format and its operand character, that 
character will no longer be capitalized. Furthermore, in 
the current svstem, any formats occurring in a string that 
is rearranged, copied or borrowed will be destroyed (they 
are transformed magically into the characters # and $). * The 
user is therefore advised to delay serious formatting until 
his editing is virtually finished. Rough draft hard copies 
can be easily obtained with the Quickie Printout feature 
(see Section 3.2.2), which requires only minimal formatting. 

The order in which the options are specified can be 
important. As described below, a single capital format 
(CAPl) will only be effective if it immediately precedes a 
letter, whereas multiple capitals format (MULT CAPS) will 
capitalize all letters (and only letters) within its jurisd¬ 
iction. Be logical when formatting, and be sure to insert 
formats in the order desired, e.g., a SKIP of 5 lines before 
an INDENT of 3 spaces. 


2.3 INTERROGATION AND DELETION OF FORMATS 


A facility is available which allows you to inquire as to 
the meaning o c , and to delete if desired, any formats 
specified previously. This is done by pressing the INQUIRE/ 
DELETE function key and lightpenning a character of the text 
display. If the character lightpenned is a format symbol (r 
or £) , all the information about it will be displayed at the 
bottom of the display. If you lightpen it a second time in 
succession, it will be deleted. Otherwise, you can lightpen 
any other symbol to inquire as to its meaning. If at any 
time you lightpen a character of the actual text, you will 

be told that it is not a format symbol. 

» 

Format symbols may also be deleted In the Edit Phase with 
either the DELETE or SINGLE DELETE functions, although this 
is done without prior knowledge of the format’s meaning. 


This will be cleaned up In. the next release of the system. 
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2.4 NORMAL ? LOR OP EVENTS 


Normally, you Croatia and edit your manuscript, using only 
the PARAGRAPH G CAPI format option (automatically active 
when the format phase is entered) and possibly the SKI? and 
INDENT options, getting a number of Quickie Printouts along 
the way, until most of your editing is finished. 

At that time, you would probably apply some ’’Alter" 
formats to the "start" of your' manuscript and apply the 
fancier "Edit" formats to the body in order to prepare for 
the final Full Printout. Remember that "Alter" formats may 
be used anywhere in your manuscript to alter its appearance 
(changing margins, switching from single to double column, 
etc.) . 
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3. PRINTING 


3. I' CONVENTIONS 



Du? to tha non-lineality of a Hypertext, certain conven¬ 
tions have been established so that the text can be printed 
lineally. As the default option, the first branch at every 
branch point is taken during the printing. However, the 
user can designate a different branch level to be taken by 
the Printer (see Pranch Level Option, Sec. 3.2.3, below). 


At print tiee 

a linked section of a Hypertext 
and is printed as such, ? with the 
footnote is terminated when another link. 


(though not necessarily at any other time), 

r - --is assumed to be a footnote 

convention that the 
a branch, or the 


END of the Hypertext fragment (area) is reached. A maximum 
of ten lines of footnotes (at the current line length) is 
allowed per printed column.' If more than ten lines are 
included, the first ten lines will be printed as a footnote 
while the rest will be included in the main text, following 
the point at which the footnote (link) occurred. 


Normally, if the user desires an expanded footnote in his 
Hypertext, but only wishes the first few lines printed in 
hard copy, he wouli signify the end of the text for the 
printed footnote by inserting, at the end, a link to any 
point on the scope page. Thus the complete link would be 
shown on the display, but only the designated portion would 
be printed as a footnote. 


If, however, he wished for the 
be printed (in-line), he would have 
linked section an 1 another branch ba 
from the end of the linked section. 


entire linked section to 
to make a branch to the 
ck to the main-line text 


2. This is a sample printed footnote. It was created as a 
linked section o c the PQ R NAT MANUAL Hypertext (in a N E VJ A REA) 
and is terminated in this example by the END of this text 
area (which is right here). 
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The Hypertext Printer reinitializes itself 
inq a printout (signified by. an audible 
scope) , so that in the same session you may 
different printouts, provided the TEXT360 
program is run in between each request for a 
the batch processing partition say). Sev 
Hypertexts can be "linked" together by us 
numbering facility described in- Section 5.9. 


different 
program is 
the batch 


after complet- 
fweeeon at the 
get• several 
"Final Print" 
printout (in 
oral different 
ing the page 


The second (and final) stage for a printout of a 
Hypertext is through TDM's THXT360 printing program. The 
Hypertext Printer is in actuality a translator which trans¬ 
forms all the text and formatting of a Hypertext into a 
lineal string of characters recognizable by the TEXT3 60 
program, thus eliminating the need for learning the mys¬ 
terious TFXT3S0 format codes, and reducing the probability 
of typographical errors. This design philosophy achieves 
two goals: first, you do not have to know anything about 
the TEXT.350 program or text formatting to produce reasonably 
pretty hard copies; and secondly, if you desire quite 
elaborate printout, the only concepts required are those of 
column widths, margins, tabs, and running heads and foots, 
or precisely those concepts understood by most competent 
secretaries. 


Uy f e < 


/ H S. 

\ V* hVer 


TtXT36 0, 


-^>1 'nte 

\ Co 9 V 


Figure 1. Flow of Printing Process 

A separate deck must be run for the TEXT350 program 
(consisting so Lei v of Job Control Language). This program 
may vary from installation to installation, but a sample of 
the . program as run at Brown University is included as 
A p p e n 1 i x A . 
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3.2 OPTIONS 


3.2.1 Full Printout 


After having formatted a Hypertext using the Format Phase 
facilities, the cull printout option causes a hard copy to 
be printed with all the specified formats plus any default 
options, with upper and lower case letters and any special 
characters specified (provided a special print chain ' ,, TN M 
or equivalent] is used). 

The FULL PRINTOUT is one of the alternatives which can be 
selected with the lightpen after pressing the PRINT function 
key. 


3.2.2 Quickie 


A facility is provided for obtaining ,f rough draft" hard 
copies of a Hypertext, requiring only a minimum of "edit" 
formatting. The copy will be in ragged-right format, in a 
single column 74 soaces wide (i.e. screen width), double 
spaced, with no hyphenation. The only formattings used are 
PARAGRAPH, PARAGRAPH S CAP1, SKIP and INDENT (REGULAR) , or 
precisely those formats which are displayed on the scope; 
consequently, the copy.will correspond, line for line, with 
the text as presented on the scope display, except that 
extra blanks between words will be removed. 3 


The QUICKIE PRINTOUT 
after Dressing the .PRINT 
useful for making edit 
entering them into the s 
cany almost line for line. 


may be chosen with the lightpen 
function key. This option is 
changes on hard copy and then 
copy, which will match the hard 


3. TEXT360 always removes extra blanks between words-- if 
you want them knot, use the AS-IS format described in Sec. 
4.1 below. 
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3.2.3 branch Level Option 


As was mentioned in Section 3.1, you may specify any 
branch level to be taken during printing. This is dona by 
selecting the PRINT OPTIONS function key, lightpenning 
".SPECIFY BRANCH OPTION™ and typing in the number of the 
desired branch level. 

For example. If you type in a fl 4 ,f , the Printer will 
determine at each branch point if at least four options are 
available. T p so, the fourth branch will be taken. If, 
however, fewer than four branches exist at that point, the 
first one will be followed. The default branch level is 
one. 
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4 . "EDIT" F03HAT COMMANDS 


* ' ."Edit” format types are basically those which one wishes 
to specify at many different points in the text. The Prompt 
Area of the display will tell you exactly what should be 
done next. The types of actions necessary were explained 
above in See. 2.1, Soecification and Types of Formats. The 
options available, arranged alphabetically, are described in 
detail below. Each section heading refers to an "edit" 
function key label (name). See Appendix D for the corres¬ 
pondence of function key label and number. 


4.1 AS—IS 


The AS-TS function key is used when a string of text is 
to be printed as it appears in the Hypertext, without line 
justification and without removing or inserting any extra 
blanks between words. This format is specified by lightpen¬ 
ning the start of all pieces of text wished printed n as-is M . 

The AS-IS mode begins a new line and is terminated by the 
next formatting that starts a new line. 4 L It is not affected 
by the right margin.] If the length (i.e., the number of 
characters) of text under control of the A5-IS format 
exceeds the current column width (see Fig. 2), the text is 
truncated, and an appropriate error message is provided in 
the user reference material printed at the end of the hard 
copy. 

A common use of the AS-IS format is to line up two 
columns of numbers. * .The AS-IS format is specified at the 
beginning of each line; if the numbers were typed in so that 
they were lined up, they would be printed out the same way. 

# 

For example, if the following table were formatted on the 
screen as shown (the on the first line represent SKIP 1, 
INDENT 10, AS-IS, and ’ two CA? 1 f s, left-to-right; on the 
second lino, SKI? 1, INDENT 10, and AS-IS; and on the last 


4. The formats which start a new line are AS-IS, 
HEADINGS, INDENT, NEW COL/PAGE, PARAGRAPH, PARAGRAPH 
and the "alter" formats. 


P K7 T* T? 7? 

*w f* r* i -i , 

$ CAP 1 , 
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w 

f-jm- lines the it's represent INDENT 10 and AS-IS; the blanks 
preceding the 0, the 1 and the 2 in the first column were 
inserted, last, through the Edit Phase), 


2 X 


#Y 


### 0 

1 
1 
2 
2 


**- 

id 

dd- 


0 


1 

1 

4 

4 


the result on the printed copy would be: 


0 

1 

1 

2 

9 


0 

1 

1 

4 

4 


This same effect could 
option, explained below. 


also be achieved using the TAB 


4.2 CAP1 




e 

' 7 


n 


mv 

ter 


ingle letter, 
e capitalizel r 
aoital format 
capitalized. 5 
the PARAGRAPH 
1 and a BEGIN 

oc; ere sneci^ied for the same character, the charac 
in question will be capitalized only once. 


This mode allows the user to capitalize a s 
If thr°e or more consecutive letters are to b 
it is quicker to use ejjlt CAPS. The single c 
must immediately proceed the character to be 
This format is combined with a paragraph under 


API option, described below. If both 

*■ - - . • t 




A P 


5. The only 
capital can bn 
charact?r wi 11 


o xce p tio n to this rule 
followed by tf BEGIN UMDEPST 


is that 
ORE’* and 


the single 
the next 


n 


cap ita1izol. 


FORMAT MAMMAL 13 



HYPERTEXT EDITING SYSTEM 


20 January, 1 OS 0 


M ED IT 11 FORMAT COMMANDS 


4.I CENTER 


The CENTER tonat is used to center a particular piece of 
text between the current left and right margins (see Fig. 
2).. This format starts a new line. Termination of the text 
to be centered is indicated by the next format request 
(other than MULT CAPS, UNDERSCORE or CAP1). If the text 
being centered exceeds the column width, it will not be 
centered, i.a ef the centering will be no-oped. 


Aesthatical note: if there are blanks between the end of 
the line being centered and the terminating format symbol, 
the centering will be incorrect (i.e., blanks at the end are 
considered to be part of the piece being centered). 


As an example, consider: 


CENTER ME 




The three blanks after 
representing CENTER) will be 
between "ME" and the second 
ing format) will be Included 


the first format symbol (i.e. 
ignored, but the two blanks 
f (the symbol for any terminat- 
in the centered line. 


4.4 DEAR TABLE 


This function key, in conjunction with DEAN LINES below, 

provides an effective method of drawing tables. Tables (or 

charts) are usually combinations of tabular text (see also 

Sec. 4.1 6 Tab (Execution) and Sec. 5.3 Tab Settings), 

horizontal and vertical lines, and their intersections (the 

proper intersection at the junction of a horizontal and 

vertical line is automatically provided). 

— ^ * 


a rc 


U '■ 

v.i vJ . 


^ c* 

» * * .y 


U hen a 


The line draw In 
started. When a 
by the user. ""are 
character does n 
character. When n 
character, the tex 
The line c liar act 
characters of a ta 
"as illustrate 1 
line and the user 
the o rinted c o r >v v 


g formats 
new line 
must also 
ot occupy 
con flirt 
t charaeta 
ars will, 
xt line, 
below." i 
fails to r 
ill be: 


do not cause a new line to be 
is required It must be specified 
be taken to ensure that a text 
the same position as a line 
exists between a text and a line 
r overrides the line character. 

however, override the blank 
For example, if the text line 
3 to be followed by a horizontal 


o request 


new line 


the re 




t on 
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a s-i11us trated-below.- 

The table formats require the specification of column 
, These oositions are alwavs measured from the 

». M 

leftmost position (position 1) of the column width. 


The Begin Table format is chosen by lightpenning "BEGIN A 
TABLE" after pressing the DRAW TABLE function key. You will 

in a series of numbers. seoarated bv 

V 1 


be asked to type 
commas: 


nn,nn,... / nn 


s 


Thi 
starting 
n r \ 1 s a n 
by the 
equivale 
vert real 
The cola 
The v o r 
E n d T a b 1 


t will cause a horizontal line to 
at the leftmost column position specifie 
d ending at the rightmost column position 
n n 1 s. 
nt to 

line in each of the column L 
mn positions need not be entered in ascend 
tical lines started by this format continu 
format (explained below) is encountered. 


The horizontal line occupies 
one text line. This format will al 


be printed 
d by the 
specifled 
the soace 
so start a 
specified, 
ing order, 
e until an 


If, instead of typing in a 
immediately presses the accent 
will cause the column positio 
Table format to be used. This 
be inserted next to a regular 
positions of the regular one 
the previous one. For example 

im *. 

is later followed by Begin T 
40), the result of the last tw 
( 5 , 10 , 15 , 20 , 30 , 40 ). 


series 


of 


n u m b e r s 


the user 
key (ALTN CODING S END) , this 
s specified in the last Begin 
"null" Begin Table format can 


one, 
will 

if 

, -L 

a ble 
o is 


in which case the column 
be combined with those of 
a Begin Table (10, 20, 30) 
(null) Begin Table (5, 15, 
effectively Begin Table 


A subsequent Benin Table format can be specified while a 
previous one is .still- operative. This subsequent code ends 
all vertical lines of the first before starting the new 
table. In this fashion, a table of varying format can be 
constructed bv using the Begin Table format rather than the 


horizontal and vertical line drawing formats described in 
the next section. 


function key 


A table started with the Begin Table format should be 
ended using the End Table format activated by lightpenning 
11 END A TABLE 1 * after pressing the DRAB T A B r p 
and then lightpenning the end of 
c a u se s all 
t o b a o r d ^ 


, f 

format 


* - A - vl 


the table. This 

vertical lines started by the Begin Table format 
'•orizonta 1 line to be printed between the 


V (L. 


a 

L 1 


Iof t-n >st nr.' 1 rightmost vortical linos of the tab 1 
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4.5 DRAW LINES 


In conjunction with the DRAW TABLE formats described in 
t.ho previous soot ion, those format options onn'olo elaborats 
tables to be printed'on the hard copy. This function key 
controls four options: "DRAW HORIZ LINE SEGS," "DRAW RDRIZ 
LINE OF BEG TABLE," "DRAW VERTICAL LINES," and "END VERT 

LINES OF ABOVE." 

If "DRAW BOR TZ LINE SESS" is chosen with the lightpen, 
the user will be asked to type in a series of numbers, 
separated by commas, desicrnating column positions between 
which to draw horizontal line segments. The numbers are 
specified, as usual, as: 

n n , n n ,.. . ^ n. n ^ n n 

The first nn specifies the column position in which the 
first segment is to begin and the second nn indicates the 
column position in which it is to end, and similarly for the 
remaining pairs of nn*s. The total number of column 
positions specified must be a multiple of two. If only 
nn,nn is specified, a single, continuous line will be drawn. 
After specifying the desired column positions, the user can 
apply this format to his text. 


i h /a r* 


If "DRAW HQRTZ LINS OF BEG TABLE" is cnosen, 
subsequently entered into the text with the lightpen, a 
horizontal. line will be printed between the leftmost and 
rightmost column positions of the most recent begin table 
format. The intersections at the vertical lines are printed 
automaticallv by the program. The line occupies one text 
line or a portion thereof. 

If "DRAW VERTICAL LIMES" is chosen with the lightpen, the 
user will again be asked to type in a sequence of numbers, 
separated by commas-, corresponding to column positions in 


which vertical lines are to be printed, 
numbers are specified in the form: 


As before, the 


nn , nn ,..., n n 

and not bo specified in ascending order. 

If, instead of typing in a series of numbers, the user 
immediately cresses the accept key (ALTM CODING G END) , this 
"null 11 vertical Lines format will cause the column positions 
so^ci^iod by the previous Vertical Lines format to be used. 
The null Vertical Lines format could inserted i^mediately 
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bofora a normal Vertical Lines format, in which case the 
column positions of the regular one will be combined with 
those of 'the previous one, analogous to the case of the 
Kaain Table f 


And finally, if "END VERT LIMES OF ABOVE" is chosen, and 
subsequently entered into the text at an appropriate point, 
all vertical linos started by the Vertical Lines format will 
be ended, in the line in which the format is specified. 
This format does not end vertical lines start ad by the 3egin 
Table format: these must be ended by the End Table format. 


4.6 FTOURBS, 


T T 

* ■ r 


LJ JL 


OF 


This option provides the 
of Figures as a supplemental 
of Contents. The List of 
if the user chooses to inciu 
be made up of the na me 
pen-pointing at the start 
the LIST o f FIGURES function 
"edit" or "alter” format cod 
UNDERSCORE) and its page 
program from its o wr out p ut. 
Figures for this manual. 


facility to have priate 
listing, similar to th 
Figures is automatically 
da at least one figure, 
of the figure (sped 
of the name after having 
key, and terminated by 
o other than MULT * CAPS, 
number, derived by the 

ds an example, see the 

*» 9 


o 

V - 


a List 
Table 
created 
and w i 11 
fied by 
pressed 
the next 
CA PI or 
TEXT 350 
List of 


£i.7 HEAD! U G S 


This feature allows the user to format headings in a 

the construction of a fairlv 


variety of 

w a v s 

i 

elaborate Ta 

b 1 e o 

system if th 

! c u s e 

t v p i n a i n a 

n u m b e 

in Table 1, 

be! ow 


a n -d 


) 1 e s 


o 


automatically created by th 
The heading types (specified by 
r in-line appearance, are given 


Heading types 1 through 4 are "stand-alone" headings, 
the text that follows them begins on a separate line. 

the heading is pointed to with the lightpen and 
the healinu is terminated bv the next "edit" or "alter" 
format cole other than capitals or un lerscore. 


X. • - • , 

The start of 


As ex a mpics, the hea din g 4.7 HEADINGS for t his 


p> — 


was soecifid as a tvpe 3 heading and was terminated by 


firs t 


oara erar>h 


_ 


this section. The headings for the 
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sections of the manual, such as 4. "EDTT” FORMAT COMMANDS 
were specific! as type 1 healings. An example of a type 4 
healing is 3.2.1 FHLL PRINTOUT. See the Table of Contents 
(TC) for examples of how each of these headings is included. 


Headings 5 and 5 are* n run 
follows them continues on 
headings S and 6 continues 
reached. 


-in" headings, 
the sa me line 


The text that 
The format of 


un til 


colon or period 


is 


The type 
left-justi r ied 
odd-numbered 
and is printed 
preceded by 
one line of te 
w i d t h {t w ice 
format). If i 
Contents and i 


1 heading begins a new page, is right- or 
on the top of the page (right-justified on 
paces, left-just ified on even-numbered pages). 
In the Table of Contents left-justified, 
1 blank line. Heading type 1 is restricted to 
xt and therefore must not exceed the column 
the column width plus three If in two-column 
t does, it will be truncated in the Table of 
n the main text. 


Head in :i 
Contents, 

1; type 3 
also begin 
of Conton 
end of the 


ally 


form 


below, the 
the Table 
inserting 


types 2-4 are also included in the Table of 
as follows: type 2 is included exactly like type 
begins a new line and is indented 2 spaces; type 4 
s a new line, but is indented 4 spaces. The Table 
ts will be printed in single-column format, at the 
main text. Although the headings are automatic- 
attocl in the actual body of text as indicated 
y must be formatted as you wish them printed in 
of Contents (e.g., only initial capitals) by 
the desired capitalization in the in-line heading. 



3 ta nd 
a 1 o n a 


All 

Can 


1 fJnder 
| score 


Skips 

Before After 




\r 

* > 


| New 

| Page 
-- 

I x 

I 

I 

I 

I 


I In 
| TC 

-f- 


ble 1. Heading Sets ana Their In-Line Appearance 
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4.8 INDENT 


The INDENT mode provides two types of indentations. The 
user will be asked to make a choice, using the lightpen, 
between "REGULAR INDENTATION" and "HANGINS INDENTATION". 
After making this choice, the user types in the number of 
snaces to indent, and finally (after hitting ALTN CODING 5 
END) he lightpons the points which he wants indented. 

A regular indentation begins a new line which is indented 


the user-specified number 


o 


spaces from the current left 


margin. A regular indentation of 0 spaces will begin a new 
line, left justified, with no intervening blank lines. A 
regular indentation is also displayed on the scope, indented 
up to a maximum of NO spaces. 


A hanging indentation begins a new line, but only the 
subsequent lines are indented the specified number of spaces 
(again with respect to the current left margin). This 
"hanging" indent mode continues until it is ended by the 
next format that begins a now line (see Footnote 4). 

Both a regular and a hanging indentation can be specified 
together (only 1 new line is begun). 

For example, if a SKIP of 1, a REGULAR INDENT of 5 and 
• a HANGING INDENT of 10 were specified at the same 
point in the text, as has been dona here, the 
first line would be indented 5 spaces and all 
followina lines would be indented 10 spaces. 


Conversely, if a SKI? of 1, a REGULAR INDENT of 10 
a HANGING INDENT of 5 were specified together, 
again as has been done here, the first line would be 
indented 10 spaces while all following lines would be 
indented onlv S spaces. 


Rest 
r i. g h 
i n d a 
r n s t 
for 


riction: the number of characters per line (i.e., the 

t margin minus the left margin, minus either of these 
ntations) should not be less than twenty. If this 
riction is violated, the indentation will not be made 
the complete number of spaces specified and a error 

the end of the printed copy, as 


r% c? ct 

ox o 


IT; rr r> 


a 7 a will a p p o a r 
aia e A in Aoceniix 


at 

C. 
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4.9 


V 7 !? n c 

i\ * i t i o 


A kopp is a reserved area (blank, or including text) of 
the printed copy which the user wants not to he split 
between columns or pages. This is used for instance to 
leave space for diagrams or Pictures in the final printed 
copy. "Then this format is chosen (by pressing the KEEPS 
function key), the user will be'presented with four choices: 
11 BESIK A PEGFJLA? KEEP," "BEGIN A FLOATING KEEP," "BEGIN A 
TWO-COLUMN KEEP," and "END ANY GF THE KEEPS." 


The facility to insert keeps, while extremely important, 
seems to present the most problems to the TEXT360 program-- 
therefore extra care should be used when selecting them. It 
also appears that the floating keep does not perform as 
indicated. It is recommended that only the regular and 
two-column keeps he used. 


The regular and fl 
room in the current 


lines if a skip of 20 
the point selected, 
the reserved area, 
reserved, by using t 
actual text.) Ho we v 
column to save the de 
are handled different 
start of the next 
remainder o~ the orev 
will also beain in 3 
will be used to com.nl 


oating keeps are similar. If there 
column, the designated space (o.g. 


r 

a 


is 
20 
a t 


of 


is use-i) will be reserved beginning 
(The keep only declares the start 
and the desired space must then be 
he SKIP format and/or by including 
or, if there is not room in the current 
sired number of lines, the two keeps 
ly. The regular keep will begin at the 
column (or page) and will leave the 
ious column empty. The floating keep 
:olumn, but text following the 
(fill-up) the previous column. 


new 


keep 


Immediately preceding the keep designation, the user 
should specify, with the skip format, by how many lines his 
keen should be separated from the rest of the text. If no 
separator is desired, a skip of 0 should be specified. 
Also, a blank character (representing a lummy character 
i n g) -should be inserted (through the Edit Phase) 


cm 

o •. 1 . 


between 


the keep designation and the format specifying the length 
the keep. 


of 


For example, to reserve 10 blank lines on the printed 
copy, separated from the main text by 1 line, the order of 
the formats would be: 1) SKIP 1 line; 2) BEGIN A KEEP; 3) 
insert at least one blank character; 4) SKI? 10 lines; and 


5) END 
e ntore! 


t ;i t? 

*. 4 

3 v , 


in ol ~ 


X r? n 
- . * 

l, ^ 1 


Of course, the blank 


a c t e r must be 


w n i r e i n t n e 




it Phase. 
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To rpsar/e an area across the full page width in the 
two-column format, a two-column keen should be specified. 
Tho column width is temporarily altered to equal twice the 
current column width plus three (the width of the gutter, 
the separator between the two columns). The reserved area 
will be placed at either the top or the bottom of that 
section of text depending on which column contains the 
request for the keep (see Figure 3). If the keep format 


request f 

or 

the 

keep 

(see 

occurs in 

t he 

1 o ? t 

co lu ra 

n of 

page) , th 

on 

the 

t w o - c 

ol’nn 


the section: if the format occurs in the right column, the 
keep will appear at the bottom of the section. Using the 
AS-TS format, the user can flow any text contained in the 
keep across the full width of the augmented column. This 
can also be done by increasing the right margin to the 
temporary width. When the keep is released (ended), the 
column width will automatically be reset to its previous 
value. 

All of the above keeps must be released by lightpenning 
"END of KERO" after pressing the KEEPS function key, and 
then pointing with the lightpen at the last character of the 
desired "kept" area. "one of these keeps should be longer 
than the specified number of lines per page (50 is assumed). 
To leave blank columns or pages, see NEW COL/PAGE below. 


4.10 MULT CAPS 


This mole enables the user to capitalize words or phrases 
of his Hypertext without having to capitalize each letter 
separately. He specifies the text to be capitalized bv 
pen-pointing at the first, and last letters of the desired 
piece, in anv order. Any non-alphabetic characters included 
in this piece are not capitalized. If only one or two 
consecutive letters are to be capitalized, CAP1 is more 
efficient. 


Caution: if a single capital (CAP1) or an "alter" format 
is specified within .a portion of text under control of MULT 
CAPS (i.o., before the END MULT CAPS format is encountered), 
the multiple capitals mode will end at the point at which 
CAP1 or the "alter" format is specified. 
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4.11 MSH COL/DA G E 


Two choices ir° available with this function key. The 
user will be asked to choose between "BESIN MEN COLUMN" (a 
new coinan will be star tel) anl "BEGIN NEW PAGE" (a new page 
will be started). these formatting options are fairly 
obvious. 


If the user specifies "BEGIN NEW COLUMN" and his text is 
being printed in single-column format, a new page* will be 
started. 

It is advisable to specify a BEGIN MEN PAGE format at the 
start of a text, following the column and margin definition 
formats (if any) described in Sec. 5.4 TEXT COLUMNS and 
Sec. 5.5 MARGINS. This allows lines to be skipped at the 
start of a text anl guarantees that your "text box’ 1 will not 
look strange (a result of having a default column width of 
74 spaces) . 

In order to f occe blank columns and/or pages in the 
printed Hypertext, these formats must be specified in secies 
with at least one blank (representing a dummy character 
string) separating each one (inserted through the Edit 
Phase). N successive occurrences of the formats will leave 
N-1 blank columns and/or pages* For example, assume each # 
represents "Begin Mew Column;" then the sequence 

t ft * # 

would cause three blank columns to be printed since four new 
columns have been started. 


4.12 FIFA1 HIPH 


This option begins a new paragraph in the printed text, 
i.e., a blank line is skipped and the following text is 
indented three snaces. (See also Sec. 3.2.4, Paragraph 
Option.) The paragraph is displayed on the scope. 
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This option combines the PARAGRAPH and CAP1 functions 
described above. A new paragraph is begun and the first 
character of the paragraph will be capitalized. The para¬ 
graph is displayed on the scope. 

This mole is automatically activated when the Format 
Phase is entered-- so the user may readily flip back and 
forth between the two Phases, paragraphing an unedited text 
for initial readability. 


4.14 SKIP 


This feature enables a user to skip a designated number 
of lines between sections of a Hypertext. The number typed 
in by the user is the number of lines to be left blank 
between the pieces of Hypertext. The skip ’is also displayed 
on the score, although at most 4 lines will be skipped on 
the display. 

To begin a new line, with no blank lines between (i.e., 
to do a "Carriage Return"), a skip of zero should be 
specified. If a skip is immediately followed by another 
format that begins a new line (see Footnote 4), an addition¬ 
al line is not skipped. For example, a skin of 2 lines 
followed by an indentation of 5 spaces will cause only 2 
lines to be left b1ank on the printed copy. 


4.15 SPEC CHAPS 


A choice of special characters not available on the 
standard 2250 keyboard is offered to the user. He will be 
asked to choose between "LEFT BRACKET" (f), "RIGHT BRACKET" 
Cl) , "PLUS OP HI WHS" (±) , and "SUPERSCRIPT" (e.g. o or 5 ) . 
The possible digits that can be superscripted are 0 throujh 
9. However, these can be combined in series to form any 
positive decimal number desired, e.cr. fX±Yl 52 . 


When Lisina a superscript to indicate the position in the 
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main text of a footnote, 6 the superscript should be entered 
so as to immediately precede the link marker (an * on the 
display) so that no blanks will appear between the .text and 
the footnote marker. You, the user, must put the same 
number on the footnote (link) itself. 


4. 15 TAP (EXECUTION) 


The TAB feature allows text to be positioned at (tabbed 
to) pre-set positions on a line. The tab stops can be set 
at any column positions desired, as explained in Sec. 5.3, 
Tab Settings. As default values, the tab settings are at 
five space intervals across the line. That is, tab position 
1 is at space 5, position 2 at space 10, etc., through 
position 20 at space 100. Of course, if the current column 
width is less than 100, only those settings corresponding to 
spaces less than or equal to the column width are applic¬ 
able. The tab positions are in relation to the column width 
and are not restricts! by the current left or right margins 
(see Fig. 2). 


Since the user has the option 
(periods) between the tabbed portions 
choose, with the lightpen (from a menu 
the display), between "REGULAR TAB" 
between tabbel sections) and "TAB WITH 
periods between tabbed sections), Th 
can be varied on the same line. After 
lightpen, which of the tabs he wants. 


of printing leaders 
of text, he must 
in the Prompt Area of 
(i.e., with blanks 
LEADERS" (i.e., with 
esa two types of tabs 
choosing, with the 
the user will type in 


the number 
to tab. 
which are 
Settings) 


corresponding to the position to 
He si.iv then lightpen the starts 
to begin (or possibly end, 
at that position. 


which he wishes 
of pieces of text 
again, see Tab 


Each 
forma t., 
control 
fragment 
the text 
will be 
the en 1 


line of tabular text must be. preceded by an AS-IS 
one f, i3-is ,T ' per line. Since the text is under 

of the A5-1S format, the end of the last tabbed 
should not overflow the column width. If it does, 
will be truncated, and an appropriate error message 
included in the user reference material printed at 
of the hard copy. 


6 . As has been done in this manual; for example the 
superscripted 6 to indicate this footnote. 
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Edition, f 


trie user 


In 

normal (flow in t) text 

the normal text oossiblv 


T t 

V 


specify that tabular text and 
are to be printed on the same line, 
continuing onto the next line. 
This has the effect of nullifying the as-is format. This is 
designated by lightpenning "END TABULAR TEXT,” one of the 
options of the TAB function hey, and then lightpenning the 
start of the normal text. No other formatting is necessary 
to end the tabular mode. 


As an example of the tabbing operation, consider the same 
example^given in Sec. 4.1, AS-IS. Here the format symbols 
have different meanings: in the first line, the S repre¬ 
sents the user's choice of SETTAB at 1=10,2=11,3=22, and the 
six Ms represent SKI? 1, AS-IS, TAB 2, CAP 1, TAB 3, and 
CAP1, respectively; in the second line, they represent - SKIP 
1, AS-IS, TAB 2, and TAB 3; in the third and fifth lines, 
AS-IS, TAB 2 and TAB 3; and in the fourth and sixth lines, 
AS-IS, TAB 1 and TAB 3. 


rt • £■ il i 4 v a a v 

4J rf * 7J \ r p- I 

# #0 - 0 
##1M 
##-1* 1 
2 * 4 

S S —2 % 4 


* ^ — j ^ ^ this 11 would hopefully look. something like 

this in your printout: 



0 

1 

- 1 
2 

-2 


0 

.1 

1 

4 

4 


4. 17 UNDERSCORE 


A means 
[fy per text is 
any order), 
this mode 


is 


last h1t 


of underlining? 


r words or phrases of a 


provided f requiring pairs of liqhtoen hits 


analoaous to the method 


use d 


in MULT CA^S. 


i s 


ended after an odd number of light pen hits, 
i i nore d . 


(in 

If 

the 
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As explained 
formats are s-° 
appears after hi 
ning the desire! 
in the order 
choices grouped 
regular fonnatt 
applled, 1ig ht pa 
the first choice 
need not specify 
this mode at all 


in Sonera 1 Remarks (Part 2), 
looted with the lightpen Ero 
tting the ALTER function key 
point in the text. They are 
in which they appear in the 


t?nt 


oyether via an inde_ 

:t rj r with all previously so 
Hnpm TJRN T0 FORMAL FORMAT-TIN- 


L n rr 

n 


Remember that due to defaul 
a single option, i.e., you ne 


the "alter" 
m a menu which 
and lightpen- 
explained here 
menu, opposite 
To return to 
lected options 
OPERATIONS," 
t options, you 
ed not go into 


5.1 LIME AMD COLUMN JUSTIFICATION 


The next four choices allow you to control line and 
column justification as you desire. 


.Line Just if ica t io n 


To accomplish 
space! out to t 
between words, 
the line are 
space equally ac 
are inserted bet 
not enough to 
inserted bet wee 
accomplish a!, a 
from the rig ht f 


line justification, all 
he line length by Inserting 
As many blanks as are necoss 
inserted. In an attempt to 
ross the column, an equal nu 
ween pairs of words in the 1 
justify the line, one 
n each word until the j 
It ornately beginning from t- 


or each successive line (see 


text lines are 
blank characters 
ary to justify 
distribute white 
rnber of blanks 
ine. If this is 
:ional blank is 

he left and then 
also Hyphena¬ 


tion, Sec. 5.2 below). 


Lines preceding a format that begins a new line, column 
or pace are not justified. Also, a line consisting of one 
word is lef t-just.if i od. 


The line justification feature is assumed 
default case and need be 
previons 


]> 


c a s e a n 
1 v s p o c i " r 


t r\ 

i_ — 


":SU P PRESS 


s oe 
T.T 


.. N E 


on 

if led only after 
JUSTIFICATION. " 


it 


as the 
h a v 1 n g 
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Colunn Justification 

When the column justification feature is "on 


it 


(the 

assume! option), all the text columns unier control of a 
given "lines per page!* format (see below, Sec. 5.3, Page 
Depth) are male equal ih length (i.e., "vertical" justifica¬ 
tion is performed) by spacing the columns, with blank lines, 
out to the page length. 

Column justification can be "turned off" by lightpenning 
"SUPPRESS COLUMN JUSTIFICATION." 


5.2 HYPHENATION 


This feature allows the last word 


o 


a- 


line to be 


hyphenated if necessary. Words of less than six characters 
are not hyphenated. Since a word can be hyphenated inco¬ 
rrectly (as was done here!), there Is a facility for the 
creation of your own hyphenation dictionary which will be 
checked before attempting any hyphenation. 

Uhen line justification and hyphenation are both opera¬ 
tive (they don f t have to be specified together) , line 
justification is attempted first. "This line justification 
differs from that described above (Sec. 5.1, Line and 
Column Justification.) in that at most o-ne blank is inserted 
between consecutive words. If this fails to justifiy the 
line, hyphenation is attempted. It is possible that a word 
cannot be hyphenated, in which case the word is moved to the 
next line and the original line is justified by inserting 
additional blanks according to the normal formula. 


The hyphenation feature 
specified only If you have 
HYPHEN ATIDN." . . 


is assumed to be "on" and need be 
previously specified "SUPPRESS 


• The hyphenation dictionary Is constructed using the next 
two features: 


To add words to the hyphenation dictionary, choose 
"INCLUDE FORDS IN t.HE . HYPHENATION Did. " from' the Alter 
Formats Menu, and then type in the correctly hyphenated 
words, separating ^ach by a comma. For example, if HYPHENA¬ 
TION and HYPERTEXT had been incorrectly hyoheaated in the 
hard copv, you would tyoe in: 

*m m W -C A . 


FOR MAT 
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HY-PHE-NA-TION,HY-PER-TEXT 

A maximum of twenty words nay be active (included) in the 
dictionary at one point in the Hypertext. Words are 
accumulated when entered via this format. The words speci¬ 
fied must be at least six, but not more than twenty-four, 
characters in length, not including hyphens. 


To c 1 e 
dictionary 
HYPHE'TATIO 
currentiy 
interroqat 
All the co 
same with 
to remembe 
effect at 
word s. 


ar out _all words previously specified from the 
and enter new ones, choose "CLEAR OUT OLD 

N DICT. AND ADD NEW WORDS." The old words 
active in the (dictionary can only be seen by 

ing nr.evj.ous format markers used to enter them, 
nvontions and restrictions mentioned above are the 
regard to any new words typed in. It is important 

r that this option will cl_ear_gut all words in 

that point, while the first option only adds new 


5.3 PACE DEPTH 


The page depth 


lines 


that can 


lines may vary fr 

JL ■» 

is 50, the value 
be changed bv 
PAGE," and typing 
per pa 70 . Differ 
the text. Only 
specification. A 
the page depth. 


is the number of lines, including blank 
anpoar in 'a text column. The number of 
on 25 lines through 75. The assumed number 
used for this manual. The page depth may 
lightpenning "SPECIFY NUMBER OF LINES PER 
in the number of lines you wish printed 
ant page depths can be specified throughout 
the text column is affected by this 
ny running heads and foots are adjusted to 


5.4 TEXT COLUMNS 


The page margins of a printed copy are determined by 
several factors. Figure 2 shows a typical breakdown of the 
various elements involved. 
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CV-e^ 


TEXT36 0 9c 
- to? —-— 


> - 10 



*i.e. 


Col. Width for single column; 

2 x Col. Width + 3 for double column. 


Figure 2. Column Width, Margins and 


— i l x cr i. 


The 
wide. 
35 oo 

4 . 

p r i n t e 
user 
define 
the s 
These 
printo 
The Ms 


"Line Printer" Page (the outer box) is 132 spaces 
Of course if narrow paper (say with a width of only 
sitions) is used, all 132 positions would not be 
d. The TF XT 360 Page (107 spaces wile) is the maximum 
column width allowed. Within this box, the user 
s his own column width. The implicit margins will be 
pace left between the User Pago and the PSXT36Q Page, 
margins can be varied by moving the paper on the 
r to the left or right of center (of the carriage), 
or °age is automatically centered in the TEXT360 Page. 


All formatting is done within the f Jser Page, with respect 
to # the lnft-irosh position (position 0) of the user’s column. 
The exolicih (i.e. settable) margins are described in 
detail in the following section (5.5 MARGINS). 
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n one or two columns. A particular 
ve to remain in effect throughout 
may be respecified as originally 
a new width, or alternated with 
(o.g., from a one-column to a 
does not cause a new page to be 
is encountered, the preceding text 
page, and the rest of the page is 


For example, if text is .being printed in two-column 
format and a column format is encountered, the page depth is 
recalculated, the text is divided between the columns, and 
if specified, column justification is performed. Then two 
lines are skipped and the remainder of the page is formatted 
as specified by the column format.. This effect is illus¬ 
trated in Figure 3. If there is not room left for at least 
five lines (per column), a new page will be started. 
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Two-Column Keeps Are Printed at 
the Top and/or Bottom of the Segment 
of Text That Specifies the Two-Cotumr 

Keep 


The Program Justifies All Segments of 
Text IF Col umn Justification is Specified 
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Footnotes Are Printed at the Bottom 
of the Segment of Text That Specifies 
the Footnote 
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single col an n is soe dried by li ghtpen nin g "PRINT T^XT 
IN ONE-COL. FORMAT AND SPECIFY •WIDTH" and typing in a 
number corresponding to the number of characters par line 
(the width). Single column with a width of 74 characters is 
the assumed format, but the width may vary from 20 charac¬ 
ters through IQ 7 . 


The 


"PRINT 

typing 

equal 

52. 


double column format is specified by lightpenning 
TEXT IN TWO-COL. FORMAT AND SPECIFY WIDTH" and than 
in the .desired width (the width of one of the two, 
columns), which may vary from 20 characters through 


5.5 MARGINS 


An (explicit) margin (see Sac. 5.4, Text Columns) is 
obtained / by temporarily decreasing the column width. The 
left and right margins are in relation to the left-most 
position of the column width (position 0).' (See Figure 2.) 

The ronroins remain in effect until respacified, and 
therefore must be reset if no longer required. 


The left margin 
LEFT MARGIN" and hyp 
a left margin of hen 
Initially, the left 
there is no margin, 
values in a text and 
desired. The left 
finally, the number 
margin minus the lef 


is specified by lightpenning "SPECIFY 
ing in a number. If "10" were typed in, 
spaces would be left for each line, 
margin is set to zero, and consequently 
The left margin may be set to different 
must be reset to zero when no longer 
margin must not exceed 37 spaces and, 
of characters per line (i.e., the right 
t margin) must not be less than 20. 


The right margin is specified by lightpenning "SPECIFY 
RIGHT MARGIN" and tv'ping in a number, this number indicating 
the column position in which the line must eni. The column 


position is measured from 
column width, not from the 


t h 


left-most position of the 


urrent left margin setting. 


Thus the length of the actual (explicit) right margin is 
^qn^l to the length of the column wrdth minus the number 
specified as the .right margin. 

an axaonle, assume that the column wrd th is set 
to 60 and the right margin to 55, as has been done 
here. Then a riaht margin of five spaces is left to 
the right of each. line. 

If, in addition r the left margin is set to 10 
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(again as has been done here) , only 45 
characters are printed per line. 

The right margin is initially set to 74, the value of the 
default s ingle-column width, thus leaving no right margin. 
The right margin specified should not be greater than the 
column width. If it is, it will be reset to the column 
width, and an error message will be printed in the user 
reference material included at the end of the printed copy. 

• ’ i 

Text under control of an AS-IS format is printed to the 
full column width and not to the setting of the left and 
right margins. 



Text can be printed either single- or double-spaced. 
Sinaie spncinor causes the text to be printed with no extra 
blank space between consecutive lines. The double spaced 
format caufjos a blank line to be inserted between each pair 
of consecutive non-skip lines. Only one extra blank line is 
added to any set of skip lines.. 

Text is assumed to be single-spaced, therefore "SINGLE 
SPACE TEXT” need be specified only to return from the 
doubla-spacing mode. 


Double-spacing is specified by lightpenning 
TEXT. ,r The extra blank lines that are added 


"DOUBLE SPACE 
are counted 


when computing the number of lines per page. Thus, double- 
spacing reduces the amount of text on a page to approximate¬ 
ly one-half the amount on a single-spaced page. Note that a 
Quickie Printout will alwavs be double-soaced. 

W ~ m im 


5.7 RUNNING HEADS AND FOOTS 


A facility is provided for including running heads 
(title, subtitle, and date) and running foots on each 
printed page of the hard copy. The running heads are 
printed at the top of each page and are aligned with the 
greatest column width specified on the page. 


A tit Id (*.q. PYPFFTFX^ EDITING SYSTEM above) is speci¬ 
fied 11 ah toon nine "SPECIFY A TITLE FOR *70 P OF EACH PAG S” 
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and typing in the desired text to be used as the title. The 
title is printed in upper case, with six intervening lines 
between it and the first line of the text page. It is 
normally right adjusted on odd-numbered pages and left 
adjusted on even-numbered pages. 


A subtitle (e.g. 


"ALTER" FORMAT COMMANDS 


above) is 


specified bv lightpenning "SPECIFY A 
EACH PACE" and typing in the desired 
is printed in upper case, with three 
and the first line of the text body. 


SUBTITLE FDR TOP OF 
subtitle. The subtitle 
blank lines be tween it 
and is aligned with the 


title. 


The date (e.g. the date printed above) is printed at the 
top of each page, on the same line as the subtitle, if 
"PRINT DATE AT TOP OF EACH PAGE" is light panned* The 
current date is always printed, on the same line as the 
subtitle, left-justified on odd-numbered pages and right- 
justified on even-numbered pages. If the user desires to 
specify his own date, he could do so by entering it as a 
subtitle. 


A rnnnInq_Fogt (o.g* FORMAT MANUAL at the bottom of each 
page) , which is printed at the bottom of the page, can be 
specified for the odd-numbered pages, the even-numbered 
pages, or both. The foot is printed in upper case with two 
blank lines between it and the last line of the page. On 
even-numbered pages, the foot Is printed two spaces to the 
right oF the page number, while on odd-numbered pages it is 
two spaces to the left. (The page number is also aligned to 
the greatest column width specified on the page.) 


To specify a running foot to be printed at the bottom of 
all even-numberel (left-hand) pages, lightpen "SPECIFY A 
RUNNING FOOT FOR EVEN-NUMBERED PAGES" and type in the 
desired "even" foot. This feature has not been used in this 
manual. 


To specif 
hand) pages, 
NUMBERED PAGE 


v a running foot for the odd-numbered (right- 
liahtoen "SPECIFY A RUNNING FOOT FOR ODD- 

y L 

S" and type in the desired "odd" foot. 


i 

The reason that the running heads 
manual are not formatted differently for 
numbered. pages is that at the start 
"Right-Hand Pages" format, described below 
was specified. As a result, the "odd" foo 
printed at the bottom of every page. 


and foots of this 
odd- and e v e n- 
of the manual the 
in Sec. 5.10, 
t FORMAT MANUAL is 


•FORMAT MANUAL 3 3 
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The maximum length of the ‘heads and foots is determined 
by the column width. If the page is formatted in one 
column, the maximum length equals the width; if it is 
formatted in two columns, the maximum length is twice the 
column width plus three. It should be noted, however, that 
the maximum length, is computed on a per page basis; if 
various column widths are used, the maximum length fluc¬ 
tuates accordingly, and the smallest column width used 
within a text should be considered when determining the 
length of a running head or foot. 


5.8 TAB SETTINGS 


In conjunction with the TAB (Execution) format described 
in Part 4, a facility is provided for specifying tab 
settings. Tabs are set by lightpenning. "SPECIFY TAB 'SET¬ 
TINGS" and typing in the tab settings in the form: 

♦ 

n =nn,n = nn,...,n=nnR 

where "n" indicates the tab number and "nn" or "nnR" 
indicates the corresponding column position in which the 
text is to begin or- end. "nn" indicates the column position 
in which text is to begin while "nnR" indicates the position 
in which text is to end (right-adjusted). The two types of 
tab stops can be in any order. Leading zeros can be omitted 
from, the column positions. Tab settings are permanently 
entered into the text until changed. 

As default tin settings, tab stops are at five-position 
intervals from column position 5 to 100 (i.e., 1=5,2=10,3= 

15 , . . . , 20= 10 0.) . When you specify tab settings, the speci¬ 
fied settings override the default settings; however, only 
the default settings are overridden. For example, if 

1=3,2=9,3=388 

were specified, the default settings for number 4 through 20 
are still operative. If subsequently 

1 = 4 

is specified, tabs 2 and 3 ace still set at positions 9 
(Left-justed) and 38 (right-justed) respectively. When a 
SET TAB format marker is interrogated, only the tab settings 
specified for that format will be described. 
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The tab number must be a value from 1 
corresponding column positions must be 
through 107. 


through 20 and the 
a value from 1 


5.9 PAGE NUMBERING 


Pages will normally be numbered sequentially beginning 
with page one. However, a facility is provided for specify¬ 
ing another number with which to begin numbering or to 
change the numbering at any point in the text. This option 
is chosen by liahtoenninc "SPECIFY PAGE NUMBER FROM WHICH TO 
BEGIN (EE)NUMBERING" and typing in the page number (a value 
between 1 and 255) . 


This facility may be 
together, by specifying 
second text begin where 
for any others. 


used to "link" different Hypertexts 
that the page numbering of the 
the first leaves off, and similarly 


If 5 were specified at the start of the 'text, the first 
page will numbered 5. If later in the text, at hard copy 
page 25, 56 were specified, pages would be numbered 

. . ...23,24,56,57,... 

The value specified must be a number that is equal to or 
greater than the number of the page being processed; 
otherwise, the format is ignored. Renumbering is generally 
not used until after a printout has been obtained so that 
you would know what page number you want. 


5.10 RIGHT-HAND PAGES 


As a default option, printed pages are formatted as 
odd-numbered (right-hand) pages and their even-numbered 
(left-hanl) backup pages, as in a bound book. To print all 
pages as right-hand pages (as has been done in this manual) 
lightpen "PRINT All/ PAGES AS RIGHT-HAND PAGES." This would 
normally be specified at the start of a text. 

When this option is specified, the running heads and 
foots and the type 1 headings will all be formatted as if on 
odd-numbered pages. In addition, any running foot specified 
for even-numbered paces will be ignored, while an odd-page 
running foot will be orinted on every race. 
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6 . APPENDICES 


APPENDIX A: SAMPLE TEXT360 PROGRAM 


Col. 72 


//TEXT36.0 JOB (1 5 13 , DPR , 1 0,5 , , T, 3) , * SAM PLE JCL 1 
//J03LIB DO DSN AM E=SYS1.T3 60,PISP=0LD 
//STSP1 EXEC PGM=FMAINT 

//SYSPRINT DD S YSOTJT= A , DCR = (EECFM=VA,L5ECL=137,BLKSTZE=14 1) 
//INTER DO DSN AM E= SHOPK1 , DISP= (, PASS) , SPACE= (CYL, (15,15)), 


// 

//EXCEPT!! 

// 

// 


DCB= (BI.KSI Z E=2 4 00,T.RECL = 60 0 , RECFM=F3) , UMIT=SYSDA 
DD DSNA ME=5 EXC FILE,DCB= { , BL.KSI ZE=30 0) , 

S?ACE= (TPK, (100,20)) ,DISP=(NEW,PASS) , 

0NIT=(SYSDA,SEP=INTER) 


//SYSIN DD DSNA ME=5YS1. P1518.AVD.T360IM,DISP = OLD,ONIT = 2314, 


// 

// 

//5TFP2 E 
//SYSPRINT 
//INTER 

// 

// 


DD 

DD 


VOLMMS=SEP= AVDPAK, 

DC3= (RECFM= FB,LR ECL = 8 0,BLKSIZ E=1600) 
PGM-BLDLIM 

SYSOOT=A , DC3=(RECFM = VA,LBECL=137,3LKSIZE=1 41) 
DSM AilE= *. STEP 1. INTER, UNIT = SYSDA, 

DIS?=(OLD,DELETE),VOLUME=REF=*.STEP=.INTER, 
DCB= (BI.KSIZ E=2400, LR-ECL = 600 ,RECFH = FB) 


//EXCEPT M DD DS N A M E = *‘ i .STEP1.EXCEPT N,DISP=( MOD,PASS) ,UNIT=2314, 


DD 


// 

//LAYFILS 

// 

// 

//S7EP3 FX EC 
//SYSPrmiT DD 
//LAYFILE 

// 

// 


DCB= (BLfCSIZ B=300) , VOLnf)F = REF=*. 3TEP1 . EXCEPTN 
DS N A ME= 3 FOR K2 , U NIT= (SYSDA,SEP = (INTER, EXCEPT!!) ) , 

DC B= (,BLKSIZF=1056,RECFM = FB,LRECL= 1 76) , 

SPACE= (CYL, (20,20) ) , DISP= (NEE,PASS) 

PG M=PLAOUT 

S Y SOUT= A,DC B=( EECF M =V A,LRECL= 13 7 ,3LK SI Z 5=141) 

DD DSN AM E=*. STFP2. I. AY FILE, DISP= (OLD, DELETE) , UNIT =SYSD A , 
DCB= (BI.KSIZ S=10 56,RSCFM = FB, LRECL=176) , 

VOLIIMF--5FF=*. STEP2. T.A YFILE 


//EXCFPTN DD DS N AMS-*. STEP 1 . EXCEPT!! , DTS P = (MOD, PASS) , !!NIT = SYSDA, 


// 

//MASTER 

// 

// 


DC B=(BLKSTZE-3 00) ,VOL MM R=PEF=*.S T EP1.EXCEPTN 
DD DSN AMS=BMASFILF,MNIT =(SYSDA,SE?= (LAYFILS,EXCEPTN)) , 
DTSP= (, PASS) , SPACK= (CYL, (20,20) ) , 

DCB=(BLKSIZE=132) 


//PRTO 1 ’ DD DS M A M F = S YSI. P1 5 18 . A VD. PRTFIL E, M NTT= 2 3 1 4 , DIS? = (OL D, P A SS) , X 
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// 

// 

//S 

//5 

//? 

//S 

// 

//K 

// 

//9 

//T 

//S 

//T 

//T 

/* 


TEP4 EXEC 
Y 5 P RI N T DD S 
RTOT DD DSNA 
XCfEPTN DD DS 

ASTER DD D 

ICT DD D 
360?NT DD 
TF.P5 EXEC 
360PT DD DSM 
36 0 PUT DD 


DC B= (RFC 
S ? AC E= (T 
PG POST 
YS00T = A, DCS 

V T*-- >’ .71 • t r> D 

1 —j O x Lj l. m 

NA ilE - ^ . STEP 
DI S? = (OLD, D 
SN r STE 

DIS P =(OLD,D 
SNAHE=SYS1. 
S Y SOUT=A,DC 
PGM= ?H MT PGM 
A II E= * • STEP3 
SYSOTJT = A, DC 


* t v _ 

A. i 4 - 

r> v 
A A , 


SA M E 
DIS ? = 


= (OL 


F3,LRECL=132,BLKSIZE= 1 32) , 
(100 ,10) } , VOL0ME =SBR= A VO?AK 

= <R E C F M = VA,LR ECL =137,3LKSIZB= 
PR TOT , D IS P= (HOD, PASS) , U:iI? = 5Y 
1. EXCEPT'!, VO L U M E =R EF■= * . 3 T SP=. 
ELETr) , U HI T=S Y S D A, DC 15 = (3LXSI3 
?3.MASTER,VOLUME=EEF=*.STS?3. 
ELETZ) , DC3= (3LKSIZE= 1 32) , UNIT 
DICT ,DI3P = OLD , DC 3= (, 3LKSIZ2=2 
3=( , LR ~CL =132,BLXSIZE=132) 

. P RTOT, DIS ?= (OLD .KEEP) ,UNIT=3 
3- (,LS ECL =132,BL KSIZE=132) 


14 1) 

S D A 

EXCEPT';, 
E = 3 0 0) 
RASTER, 
=5YSDA 
0 0 0) 


Y 3 D A 


The DSNAHE for SYSIH (here SYS 1.P1513.AVD.T360IN) must correspond 
to the DSNANE for the DD card OUT of the Hypertext Sditinj Syster 
program, described in the Appendices of the Edit Phase Manual. 
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APPENDIX C: TEXT36C FEPOP MESSAGES 


At the end 
includes a sect 
FOOTNOTES, AND 
distinct types 
"alter” cole so 
footnote lino 
partial reorese 
text (see Fig. 
TEXT360. The e 
general of into 


of a printed document, the TEXT360 program 
ion called ALTER CODES, EXPANDED EDIT CODES, 
FEROP MESSAGES. This listing can contain four 
of entries. When applicable, it contains every 
ecified and its location in the text, every 
and its location, every line that has only a 
ntation in the Edit Code Field of the printed 
5), and any error messages that are issued by 
rror messages are the only entries which are in 
rest to the Hypertext user. 


(In addition to the footnote lines, the program also lists 
the text line that contains the footnote. If the footnote is 
embedded within a text line, the portion that precedes and the 
portion that follows the footnote are assigned a line number. 


Any "edit” code that is partially represented in or 
overflows the Edit Code Field of the printout causes an entry 
in this listing. The program lists the complete "edit” code 
and the text line in which it appears.) 


For the quick recognition of error messages, the error 
messages arc set off from the remaining classes of entries. 
The error .message informs the user of the type of error, the 
corrective action (if any) taken by the program, and the 
location at which the error occurred. The text line in error 
is printed following the error message. The TEXT360 error 
messages are listed below. From the given page and line 
number, and the type of error detected, you should be able to 
discover your mistake. If not, call us. The correction 
should then be made in your Hypertext. 
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APPENDIX F: TEXT360 ERROR MESSAGES 


The TEXT360 program can detect certain error conditions within the input text. If an 
error is detected, the program issues the appropriate error message in the error 
message listing (see "user Reference Material"). The program lists the error message 
number, the error message, and in the line immediately following the error message, the 
program lists the page and line number at which the error occurred and the erroneous 
text. 


This appendix lists, in ascending order, the error messages that can be printed by 
the program. Each error message is accompanied by a brief explanation of the error 
message and the action the program takes. The program action affects only the print 
tape; the erroneous data, as specified in the input text, is written on the master 
tape, and it must be corrected by the user. 


T360.001 NO DELIMITER FOLLOWING INSERT CODE 


Explanation: Terminal + delimiter is missing.. 


Program Action: The program ignores the insert code. 


T360.002 



UPDATE CODE OUT OF SEQUENCE 

Explanation: The page and line number of the code is less than that of the 

one that precedes it. 


Program Action: The program ignores the code that is out of sequence by 
skipping to the next code. 


T360.003 WORD REPLACE EXCEEDS 20 CHARACTERS 

Explanation: The "old" portion of the +ppplllRold+new code exceeds 20 

characters. 

Program Action: The program ignores the complete replace code. 


T360.004 WORD REPLACE NOT FOUND AT SPECIFIED LOCATION 

Explanation: The "old" portion of the +ppplllRold+new code cannot be 

located at the page and line specified. 

Program Action: The program ignores the code. 


T360.005 COPY SPECIFIED AS AN UPDATE TO COPIED TEXT 

Explanation: This message is issued when a request to copy text into text 

that has been copied is received. This type of copy must be specified as 
three separate copies. 

Program Action: The program ignores the nested copy code. 
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T360.006 


INVALID COPY CODE OR COPYOFF SYNTAX 


Explanation: The +ppplllC or +COPYOFF code is specified incorrectly, 

■ « 

Program Action: The program ignores the.code. 

• '■ • - „ 

T360.007 UPDATE CODE HAS IMPROPER CLOSING DELIMITER 

Explanation: The update code is specified incorrectly. 

Program Action: The program ignores the update code. 

T36C.00S SPECIFIED PAGE-LINE NUMBER NOT ON OLD MASTER TAPE 

Explanation: The page and line specified for the update code is not on the 

master tape. 

Program Action: The program ignores the update code. 

T360.009 INVALID ENCODED CHARACTER 

Explanation: The input contains a character not defined in the TEXT360 

character set. 

Program Action: The program ignores the invalid character. 

T360.010 TEXT360 CANNOT REPOSITION TO START OF COPY 

Explanation: The TEXT360 program cannot reposition the old master tape to 

the location of processing before the copy was initiated. 

Program Action: The program continues to process from the copied location. 

» 

SK. i ..... . * ^ - 

T360.011 ALTER CODE PROCESSING OUT OF SYNCHRONIZATION 

Explanation: The program, as the result of improper input, is processing 

out of synchronization (i.e., text as codes and codes as text). 

Program Action: The program can determine after a certain amount of text 
has been processed that it is out of synchronization and corrects‘itself. 

9 

T360.012 REMAINING INPUT NOT PROCESSED BECAUSE OF ERRONEOUS UPDATE SPECIFICATION 

Explanation: The update to the master file is specified in such a way that 

the program cannot process it. 

Program Action: The program prints the first card of the flushed input 

immediately following the error message. 

T360.013 TOO MANY SEARCH AND/OR REVISE REQUESTS; REQUEST IGNORED 

Explanation: When the SEARCH or REVISE code was encountered, 60 such codes 

were operative. 

Program Action: The program ignores the code. 
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T360.014 



T360.015 


T360.101 


T360.102 



T360.103 


T360.104 


T360. 10!j 



V 


INVALID SEARCH OR REVISE REQUEST FORMAT 

Explanation: The SEARCH or REVISE code is either specified incorrectly or 

the character count exceeds the maximum of. 20. 

■ * 

Program Action: The program ignores the code. 


SEARCHOFF OR REVISEOFF REQUEST NOT FOUND 

Explanation: The SEARCHOFF or REVISEOFF code is not specified exactl y the 

same as the code it is to end. 

Program Action: The program ignores the code. 


INVALID n VALUE SPECIFIED FOR -Hn- CODE; -10- ASSUMED 

Explanation: The -Hn- code is specified as -HO- or -Hn- where n is greater 

than 6. 

Program Action: The invalid -Hn- code is accepted by the program; however, 
it is processed as a -10- code. 

n NOT SPECIFIED FOR -Hn- CODE; -10- ASSUMED 

Explanation: The -H- edit code is an invalid code. The code must be 

specified with 21 numeric character from 1 to 6. 

.Program Action: The invalid -H- code is accepted by the program; however, 
it is processed as a —10— code. 

n NOT SPECIFIED FOR -?n- CODE; -10- ASSUMED 

+ 

Explanation: The -?- is an invalid code. The code must be specified with a 

numeric character from 1 to 15. 

Program Action: The invalid -?- code is accepted by the program; however, 

it is processed as a -10- code. 


INVALID n SPECIFIED FOR -?n- CODE; -10- ASSUMED 

Explanation: The -?n- code is specified of as -?0- or -?n- where n is 

greater than 15. 

Program Action: The invalid -?n- code is accepted by the program; however, 
it is processed as a —10— code. 


x NOT SPECIFIED FOR -Xx- CODE; NO EXCEPTION GENERATED 

Explanation: The x value of the -Xx- code is not specified. 

Program Action: The invalid -X- code is accepted by the program; 
the program does not assign an exception value to the text line. 


however. 
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T360.106 -Snn- EXCEEDS PAGE DEPTH; CODE SET TO -Sl- 

Explanation: The skip specified by the -Snn- code is greater than the page 

depth. - 

Program Action: The program sets the -Snn- code to -S1-. * - 

' “ . - 

T360.107 n VALUE GREATER THAN 20 SPECIFIED IN -Tn- CODE; CODE SET TO -Tl- 

Explanation: The n value specified in the -Tn- code is greater than 20. 

Program Action: The program sets the -Tn- code to -T1-. 

T360.120 INVALID ALTER CODE 

Explanation: The alphabetic portion of the alter code does not represent a 

valid code. 

Program Action: The alter code is accepted by the program; however, the 

only action initiated by the code is to start a new line. The code is 
assigned a page and line number and is printed in the alter code listing. 

T360.121 NO NUMERIC VALUE FOLLOWING ALTER CODE; MAXIMUM ASSUMED 

Explanation: The numeric value of the alter code is not specified. 

Program Action: The program assumes the maximum parameter of the code. 

T360.123 COLUMN WIDTH GREATER THAN MAXIMUM; SET TO MAXIMUM 

Explanation: The number of characters specified for the column width 

exceeds the maximum number that can be specified. 

Program Action: The program sets the column width equal to the maximum 
number of characters that can be specified. 

» 

T360.124 COLUMN WIDTH LESS THAN MINIMUM; SET TO 20 

Explanation: The number of characters specified for the column width is 

less than 20. 

• • 

Program Action: The program sets the column width to 20. 

•• 

T360.125 MARGIN EXCEEDS MAXIMUM, SET TO MAXIMUM 

Explanation: The margin specified by the +MARGIN code exceeds the maximum 

that can be specified. 

Program Action: The program sets the margin to the maximum. 

T360.126 LINE LENGTH GREATER THAN COLUMN WIDTH; SET TO COLUMN WIDTH 

m 

Explanation: The number of characters specified for the line length exceeds 

the number of characters specified for the column width. 

Program Action: The program sets the line length equal to the column width. 
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T360«127 LINE LENGTH LESS THAN MINIMUM; SET TO 20 



Explanation: The number of characters specified for the line length is less 

than 20. 


Program Action: The program sets the line length to 20 


T360.128 PAGE NUMBER SPECIFIED AFTER PAGE PROCESSED; CODE IGNORED 


Explanation: The «-PAGEnn+ or +REPAGEnn+ 

specified by the code has been processed. 


code is entered after the page 


Program Action: The program accepts the code, but it is not processed. 


T360.129 CLOSING DELIMITER NOT SPECIFIED IN ALTER CODE, DELIMITER ASSUMED 

Explanation: The alter code is entered with an opening delimiter but the 

closing delimiter is not specified. 

Program Action: The program assumes the presence of a t 

T360.130 n NOT SPECIFIED FOR Jn CODE WITHIN +DEFINE; J IGNORED 

Explanation: The n value of the Jn code within the DEFINE code is not 

specified. 

Program Action: The erroneous portion of the DEFINE code is ignored by the 
program; the remainder of the code is processed. 



T360.131 HANGING INDENTION VALUE WITHIN +DEFINE CODE TOO LARGE 

Explanation: The line length minus the margin and hanging indention is less 

than 20. 

Program Action: The program assumes a hanging indention of zero. The zero 
is assumed only at the location at which the error message occurred. 


T360.132 INDENTION VALUE WITHIN +DEFINE CODE TOO LARGE 

*’ % 

Explanation: The line length minus the margin and indention is less than 

20 . 

Program Action: The program assumes an indention value of zero. The zero 

is assumed only at the location at which the error occurred. 


T360.133 n NOT SPECIFIED FOR I CODE WITHIN +DEFINE; I IGNORED 


Explanation: The n value of the In code within the ^DEFINE code is not 

specified. 



Program Action: The erroneous portion of the +DEFINE code is ignored by the 
program; the remainder of the code is processed. 


j 
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T360.134 n NOT SPECIFIED FOR S CODE WITHIN +DEFINE; S IGNORED 

Explanation: The n value of the Sn code within the +DEFINE code is not 

specified. 

Program Action: The erroneous portion of the DEFINE code is ignored by the 
program; the remainder of the code is processed. 

• ' 

T36&.135 INVALID ENTRY WITHIN +DEFINE CODE; INVALID ENTRY IGNORED 

Explanation: An unacceptable code is specified within the +DEFINE code. 

Program Action: The invalid portion of the DEFINE code is ignored by the 

program; the remainder of the code is processed. 

T360.136 = ASSUMED IN +DEFINE CODE 

Explanation: The = is not specified within the DEFINE code. 

Program Action: The program assumes the presence of an =. 


T360.137 ? NOT FOUND IN +DEFINE CODE; CODE IGNORED 

Explanation: The ? is not specified within the DEFINE code. 

Program Action: The program ignores the code. 

T360.138 NO NUMERIC VALUE FOLLOWING ? IN +DEFINE CODE 

-<• . . * 

Explanation: The numeric value that must follow the ? in the DEFINE code 

is not specified. 

Program Action: The program accepts the code; however, it does not initiate 
any action. The code is assigned a page and line number and is printed in 
the alter code listing. 

T360.139 INVALID NUMBER FOLLOWING ? IN +DEFINE CODE; CODE IGNORED 

Explanation: The ? in the DEFINE code is followed by a 0 or a number 

greater than 15. 

Program Action: The program ignores the code. 


T360.140 INVALID TAB NUMBER SPECIFIED IN +SETTAB CODE 

Explanation: A tab number (indicated by n in the +SETTABn=nn+ code) is not 

specified or specifies a non-numeric character. 

Program Action: The program accepts and processes the code up to the point 
of the error; the remainder of the code is ignored. The complete code is 
assigned a page and line number and is printed in the alter code listing. 
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T360.141 


INVALID COLUMN POSITION SPECIFIED IN +SETTAB CODE 


Explanation: A column position (indicated by nn+ in the +SETTABn=nn code) 

is not specified or specifies a non-numeric character. 

• 

Program Action: The program accepts and processes the code up to the point 
of the error; the remainder of the code is ignored. The complete code is 
assigned a page and line number and is printed in the alter code listing. 


T360.142 TAB NUMBER WITHIN +SETTAB GREATER THAN 20 

Explanation: The SETTAB code specifies a tab number greater than 20. 

Program Action: The erroneous tab number and its column position are 

ignored by the program. The remainder of the code is processed. The 
complete code is assigned a page number which is printed in the alter code 
listing. 


T360.143 COLUMN POSITION WITHIN +SETTAB GREATER THAN 107 

Explanation: The SETTAB code specifies a column position greater than 107. 

Program Action: The erroneous column position and its tab number are 

ignored by the program; the remainder of the code is processed. The 
complete code is assigned a page and line number and is printed in the alter 
code listing. 

-vT360*144 PAGE DEPTH GREATER THAN MAXIMUM; SET TO 75 

Explanation: The number of lines specified for the page depth exceeds 75. 

m 

Program Action: The program sets the page depth to 75. 


T360.145 PAGE DEPTH LESS THAN MINIMUM; SET TO 25 

Explanation: The number of lines specified for the page deDth is less than 

25. 

Program Action: The program sets the page depth to 25. 

T360.146 HYPHENATION DICTIONARY OVERFLOWED 

Explanation: The maximum of 20 words that can be entered in the hyphenation 

dictionary has been exceeded. 

Program Action: The first 20 words submitted to the dictionary are entered. 
The remaining words are ignored. 


T360.151 INSUFFICIENT INFORMATION FOLLOWING -G- CODE 

.. Explanation: The -G- code is specified with only one column position. 

Program Action: The -G- code is accepted by the program; however, no line 
is drawn. The code is assigned a page and line number and is printed in the 
alter code listing. 
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T360.152 NO COLUMN POSITIONS SPECIFIED WITH -G- CODE 


Explanation: The line parameter is not specified with the -G- code. (-G- 
does not print the last specified horizontal line.) 

Program Action: The -G~ code is accepted by the program; however, no 
processing takes place. It is assigned a page and line number and is 
printed in the alter code listing. 


T360.153 ODD NUMBER OF COLUMNS SPECIFIED WITH -G- CODE 
# 

Explanation: The number of column positions specified by the -G- code is 

not a multiple of 2. 

Program Action: The complete code is accepted by the program; however, the 
last unpaired column position is not processed. 


T360.154 -Qnn- CODE FOR A NONEXISTENT VERTICAL LINE 

Explanation: The -Qnn- code specifies the ending of a non-existing vertical 

line. 

Program Action: If the code specifies the ending of only one vertical line, 
the code is accepted by the program, but it is not processed. If the code 
specifies the ending of several lines, the erroneous portion of the code is 
ignored; the remainder of the code is processed. 


T360.155 NO COLUMN POSITION SPECIFIED WITH -BB- CODE 

Explanation: The -BB- code is specified without column positions. 

Program Action: The code is accepted by the program, but it is not 
processed. 


T360.156 NO COLUMN POSITION SPECIFIED WITH -W- CODE 

Explanation: The .—W- code is specified without column positions. 

Program Action: The code is accepted by the program, but it is not 

processed. 


T360.157 INSUFFICIENT INFORMATION FOLLOWING -B- CODE 

v 

Explanation: The -B- code is specified with only one column position. 

Program Action: The -B- code is accepted by the program; but it is not 
processed. 


T360.158 NUMBER OF VERTICAL LINES STARTED BY -B- AND/OR -BB- CODES EXCEEDS 22 

Explanation: The total number of vertical lines, started by the -B- or -BB- 

code exceeds 22. 

Program Action: The program processes the first 22 lines requested; the 
remaining requests are ignored by the program. 
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T360.160 


ATTEMPT TO OVERLAY VALID CHARACTER WHILE CONSTRUCTING A TABLE 


T360 


T360 


T360 


1360 


T360 


T360 


T360 


Explanation: The -B- or -E- edit code specifies the column position that 

already contains text. 

Program Action: The program suppresses the line character. 

.161 ATTEMPT TO PLACE VERTICAL LINE BEYOND COLUMN WIDTH 

Explanation: The -V- code specifies a column position greater than the 

column width. 

* . 

•.Program Action: The program accepts the code, but it is not processed. 

.162 ATTEMPT TO OVERLAY VALID CHARACTER WHILE DRAWING HORIZONTAL LINES 

Explanation: The -G- code specifies a horizontal line to be printed in a 

line position that already contains text. 

Program Action: The program suppresses the line character. 

.163 BEGIN TABLE LINE DRAWN BEYOND COLUMN WIDTH 

Explanation: The -B- code specifies a column position greater than the 

column width. 

Program Action: The program accepts the complete code; however, the table 

line is drawn to the column width only. 

.'164 ATTEMPT TO END NONEXISTENT TABLE 

Explanation: An —E- code is specified while no -B- code is operative. 

"" • 

Program Action: The program accepts the code, but it is not processed. 

>» 

.165 TOO MANY VERTICAL LINES SPECIFIED 

Explanation: Explanation: The total number of vertical lines specified by 

the -V- or -W- code exceeds 22. 

Program Action: The program processes the first 22 lines requested; the 

remaining lines are ignored. 

4 

4 • 

.167 ATTEMPT TO OVERLAY VALID CHARACTER WHILE DRAWING VERTICAL LINE 

Explanation: The -V- edit code specifies a column position that already 

contains text. 

Program Action: The program suppresses the line character. 

.181 AS-IS TEXT EXCEEDS 140 CHARACTERS 

Explanation: The length of the text that is under the control of one -A- 

code exceeds 140 characters. 

Program Action: The program starts a new line with the extra characters. 
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T360.182 INVALID EDIT CODE 

Explanation: The alphabetic portion of the edit code does not represent a 

valid edit code. 

Program Action: The edit cdde is accepted oy the program, but the invalid 

portion of the code is not processed. 


T360.183 EDIT CODE PROCESSING OUT OF SYNCHRONIZATION 

9 

Explanation: The program, as the result of improper input, is processing 

out of synchronization (i.e., text as codes and codes as text). 

0 

» . • 

Program Action: The program can determine after a certain amount of text 

has been processed that it is out of synchronization and correct itself. 


T360.184 AS—IS TEXT EXCEEDS COLUMN WIDTH 

Explanation: The number cf printable characters of the text line exceeds 

the column width. 

* * * v 

% 

Program Action: The program truncates (on the print tape only) the text at 
the column width. 

T360.186 LINE LENGTH MINUS MARGIN AND INDENTION IS LESS THAN 20 

Explanation: The line length minus the margin and indention reduces the 

printable line to less than 20 characters.* 

Program Action: The program sets the indention to 0. 


T360.187 LINE LENGTH MINUS MARGIN AND HANGING INDENTION IS LESS THAN 20 

Explanation: The line length minus the margin and hanging indention reduces 

the printable line to less than 20 characters. 

Program Action: The program sets the hanging indention to the maximum 

indention that permits a 20 character line. 


T360.188 MORE THAN 6 EDIT CODES IN COMBINATION 

Explanation: Because normal text formatting seldom requires a combination 

of more than 6 edit codes, this message is issued when the combination 
exceeds 6. This message usually indicates processing out of synchronization 
. (i-e., text as edit codes). 

.Program Action: The first six codes are processed; starting at the seventh 
code through to the next edit code, the input is processed as text. 


T360.189 KEEP EXCEEDS PAGE DEPTH; KEEP RELEASED 

Explanation: The space required for the specified regular or floating keep 

is greater than that of one column. 

Program Action: The program releases the portion of the keep that exceeds 
the length of the column. 
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A HYPERTEXT EDITING SYSTEM FOR THE /360* 
Steve Carmody, Theodor H. Nelson, 

David Rice and Andries van Dam 
(Brown University; The Nelson Organization, Inc; 
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The Brown University Hyper¬ 
text Editing System is a comput¬ 
er system for text handling and 
display, having a number of 
helpful.and intertwined uses. 

It is' both a sophisticatea 
system for the composition and 


1. For a fuller explanation of 
the system, its goals and its 
planned improvements, see the 
full paper by the same title, 
submitted to the 1969 SJCC. 


manipulation of manuscripts, and 
a ' reading machine on which to 
browse and query written 
materials having complex 
structure. 


By Hypertext we mean strings 
of text arbitrarily interwoven 
and connected, i.e„, nonlineal 
text. 


In the Edit Phase, a user can 
create and manipulate Hypertexts; 
in the Format Phase he can for¬ 
mat a Hypertext and convert xt 
to conventional hard copy manus¬ 
cript form. 
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II-?H2_EDIT_£HASE 


The Hypertext editing func¬ 
tions currently available to the 
user on our 2250 MOD I display 
console fall into three main 
categories: Edit Commands, Tra¬ 
vel Commands, and Structure Com¬ 
mands* Combined, these func¬ 
tions allow a user to create new 
text, to edit text which has 
been previously typed into the 
system, to browse through text 
which already exists, and to 
structure a text in any manner 
desired, either while it is 
being created, or after the 
entire text has been written as 
a Hypertext. 


edit_commands 

INSERT: 

Allows the user to type new 
text into the place he wishes to 
insert it. As he does this, the 
text spreads to form as large a 
gap as is needed for him to type 
his insertion. There is alsc an 
offline program which will 
accept card image data. 


arbitrary length string from one 
section of a Hypertext to anotn- 
er *(cf. COPY) . 


COPY: 

Allows the user to copy text 
from one section of the manus¬ 
cript to another section (dar¬ 
ters from REARRANGE in thar COPY 
does not delete the string from 
where it was originally). 

BORROW: 

Same as COPY above, only the 
user has the option of supplying 
a citation or ‘’explainer, 11 which 
then appears after the string of 
text copied and after each sub¬ 
sequent insertion of the copied 
string in the text. 

SUBSTITUTE: 

Allows the user to replace a 
text string already in the manu¬ 
script by typing a new one in. 

MAKETAG: 

Allows the user to make “mar¬ 
ginal notes” to himself. These 
are displayed at the bottom of 
the screen in a protected area, 
but are not printed in the ham 
copy. 


DELETE: 

Allows the user to delete 
arbitrarily sized text.strings 
and structures from a continuous 
piece of text. 


DELETE SINGLE CHARACTER: 

Same as DELETE above only the 


user need only activate- the 
function Key once and then may 
continuously delete any number 
of single characters. 


INSTANCE: 

Allows the user to “subrou¬ 
tine” a piece of text by giving 
it a name. It is called where 
needed by using the function 
INSERT INSTANCE. 


INSERT 


M C? rp i vp 
L'i «T> 1 a LS ^ 



Allows the user 
previously created 
insert it into the 


to retrieve a 
instance ana 
text. 


REARRANGE: 

Allows the user to move an 


Two functions which make a 
text more readable are: 


H. E. S 
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PARAGRAPH: 

Allows the user to paragraph 
any section of the text on the 
scope. Multiple paragraphing at 
the sane point provides a con¬ 
venient method of skipping lines 
on the display. 


UNPARAGRAPH: 

Allows the user to unpara¬ 
graph any point that he has 
previously paragraphed. 


STRUCTURE COM MANDS 
MAKRLABEL; 

Allows the user to identify a 
particular section of text with 
a label which can later be 
retrieved via the GSTLABEL 
command. 

HAKELINX-. 

Allows the user to tie 
together different pieces of the 
text, or to make links 2 to new 
areas which themselves have .all 
the,properties of a Hypertext. 

MAKE30ANCH: 

Similar to MAKELINK in that 
it allows a user to structure a 
Hypertext. However, a branch 
point stops the lineal flow of 
text, and at that point the user 
must decide which fragment of 
the text he is to follow. Any 
number of branches are possible. 


2. One interpretation of a link 
is that of a super—footnote 
(i.e., an optional fragment of 
text which the user can 
reference as desired). Or a 
Link may be an autonomous piece 
of text from which the user may 
choose not to return. 


forming. a branch menu (as in 
programmed texts). 


TRAVE L COMHANDS 

LI NK: - —— - 

Allows the user to follow a 
link to a different part of tne 
text. ' 

BRANCH: 

Allows the user to take' a 
branch (possibly one of many 
available at this point) to a 
different part of the text. 

G STL ABEL: 

Allows the user to access a 
complete list of all the labels 
in the text, and the ability to 
transfer to any of these labels. 

RETURN: 

Allows the user to return via 
a. pushdown stack to the last 
point from which he either 1) 
took a branch, 2) took a liuK, 
or 3) .retrieved a label. a user 
may make many such jumps before 
retracing any. 


A continuous piece cf text is 
treated as if it were on a 
single long piece of paper, 
allowing the user to move for¬ 
ward or backward through it by 
SCROLLing: 

SCROL L FORWA RD B Y LINS: 

Allows the user to move tne 
screen image forward one line at 
a tine. "• 

SCROLL_BACKWARD_BY_LINE: 

Allows the user to move tne 
screen display backward one 
line, as might be expected. 
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Similar to the above, a 
beiruj thought of as one 
screen display. 


page 

full 



SC RO LL BACKWARD BY PA GE 
Similar to above. 
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III_THE_FOSHAT_PHAS3_1?0HMATTING 

ANlPRjyilMl 


Having created a Hypertext, 
it is desirable to be able to 
print it out in a meaningful and 
final form. 3 Therefore, the 
facility to indicate simple cr 
complex formatting directly from 
the Scope, and to print out the 
Hypertext in hard copy form, has 
been implemented. The actual 
printing is dene by IBM's TEXT/ 
360 text printing program. 

The formatting options avail¬ 
able to the user are those 
•recognizable by IBM's TEXT/360. 
Included among them are capita¬ 
lization and underscoring, para¬ 
graphing, indenting, skipping 
lines, automatically entering 
headings into a table of con¬ 
tents, formatting variable page 
and column layout, arbitrary 
running heads and foots, special 
characters not' available on the 
2250, tables, etc. 

The formats are designated by 
a marker appearing on the 
screen, which can later be 
interrogated and deleted if 
desired. The facility to sup¬ 
press these markers on the dis¬ 
play is also available, making 
the text more readable. 

V 

All the travelling commands 
described in Part II above are 


3. This paper itself was natur¬ 
ally produced by the system. 


available while formatting, and 
the user can flip between xne 
editing and formatting phases 
via a function key. 

Since a Hypertext is meant to 
be non—lineal# certain conven¬ 
tions are necessary to produce a 
lineal printed text. As the 
system is currently implemented, 
the first level of a linked 
section of Hypertext is printed 
as an inline footnote. At every 
branch point, the default branch 
taken is the first. However, 
the user can, if he wishes, 
specify a different branch level 
to be taken. For example, if he 
specifies the fifth branch, at 
every branch point the branch 
menu will be examined; if at 
least five branches exist, the 
fifth will be taken. However, 
if less than five are present, 
the printer routine will take 
the first branch. 


Since these conventions are 
somewhat limiting, a design rs 
underway to print out the entire 
Hypertext, with suitable cross- 
references, including a map 
designating the location of each 
section in the output. 

Also available is the facili¬ 
ty to print out an image of the 
current screen display, without 
detailed formatting (e.g., no 
line justification). This form 
of output would be analogous co 
a rough-draft copy. 
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IV PAGING 


The Hypertext Editing System 
utilizes a paging system to 
retie've from disk pages corres¬ 
ponding to an area of the Hyper¬ 
text selected by the user. 
Pages not currently being viewed 
by the user are stored back on 
disk only when new pages are 
requested and cere is full. 

A nice characteristic of the 
paging system is its ability to 
accomodate variable size pages 
up to 7200 bytes long. This 
allows better storage usage 
(both in core and in the data 
set) and 'greater speed in page 
manipulation and updating. 


When a user begins a session 
with the editing system, tie 
designates his Hypertext data 
set, which is then copied onto a 
scratch area on disk. All nis 
editing and formatting changes 
are entered into this work area 
and are only made permanent when 
the user specifies COPY TO DloK 
or FINISH, at whica point ms 
original data set is replaced by 
the newly edited version. Tins 
technique allows another accent- 
reject level for the user, and 
in addition, (as a precaution 
when running in a multi¬ 
programming environment) this 
procedure eliminates complete 
destruction of his data set rn 
case the operating system should 
fail. 


* 
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